JSPM

  • Created
  • Published
  • Downloads 27323
  • Score
    100M100P100Q155256F
  • License MIT

A pure JavaScript QRCode encode and decode library.

Package Exports

  • @nuintun/qrcode

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@nuintun/qrcode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

QRCode

A pure JavaScript QRCode encode and decode library.

NPM Version Download Status Snyk Vulnerabilities Dependencies

QRCode guide and demo

QRCode guide

QRCode example

QRCode example use worker

Modify from kazuhikoarase/qrcode-generator and cozmo/jsQR

Usage

Encoder

import { Encoder, QRByte, QRKanji, ErrorCorrectionLevel } from '@nuintun/qrcode';

const qrcode = new Encoder();

qrcode.setEncodingHint(true);
qrcode.setErrorCorrectionLevel(ErrorCorrectionLevel.H);

qrcode.write('你好世界\n');
qrcode.write(new QRByte('hello world\n'));
qrcode.write(new QRKanji('こんにちは世界'));

qrcode.make();

console.log(qrcode.toDataURL());
Methods
  • getModules(): boolean[][]

    • Get qrcode modules matrix.
  • getModuleCount(): number

    • Get qrcode module count.
  • setVersion(version: number): void

    • Set qrcode version, if set 0 the version will be set automatically.
  • getVersion(): number

    • Get qrcode version.
  • setErrorCorrectionLevel(errorCorrectionLevel: ErrorCorrectionLevel): void

    • Set qrcode error correction level.
  • getErrorCorrectionLevel(): ErrorCorrectionLevel

    • Get qrcode error correction level.
  • setEncodingHint(hasEncodingHint: boolean): void

    • Set qrcode encoding hint, it will add ECI in qrcode.
  • getEncodingHint(): boolean

    • Get qrcode encoding hint.
  • write(data: string | QRByte | QRKanji | QRNumeric | QRAlphanumeric): void

    • Add qrcode data, if string will use QRByte by default.
  • isDark(row: number, col: number): boolean

    • Get byte with row and col.
  • make(): void

    • Make qrcode matrix.
  • toDataURL(moduleSize?: number, margin?: number): string

    • Output qrcode base64 gif image.
Custom ECI
import { Encoder, QRByte } from '@nuintun/qrcode';

const qrcode = new Encoder();

qrcode.setEncodingHint(true);

// Custom your own encode function return bytes and encoding
// The encoding value must a valid ECI value
// Custom ECI only support QRByte mode
// https://github.com/zxing/zxing/blob/master/core/src/main/java/com/google/zxing/common/CharacterSetECI.java
qrcode.write(
  new QRByte('hello world', data => ({
    encoding: 26,
    bytes: [104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100]
  }))
);

qrcode.make();

console.log(qrcode.toDataURL());

Decoder

import { Decoder } from '@nuintun/qrcode';

const qrcode = new Decoder();

qrcode
  .scan('https://nuintun.github.io/qrcode/example/qrcode.jpg')
  .then(result => {
    console.log(result.data);
  })
  .catch(error => {
    console.error(result.data);
  });
Methods
  • setOptions(options: { inversionAttempts: 'dontInvert' | 'onlyInvert' | 'attemptBoth' | 'invertFirst' }): void

    • Set decode options.
  • scan(src: string): Promise<DecoderResult>

    • Decode a qrcode from image src.
  • decode(data: Uint8ClampedArray, width: number, height: number): DecoderResult

    • Decode a qrcode from image data.