wabr-nodejs

Web API Barcode Reader Server  (WABR) offers a REST API for the Inlite Research ClearImage Barcode Recognition technology.
This wabr-nodejs SDK simplifies the WABR client-side Node.js development.

Use wabr.ts from this repository in your project; Use sample code from test.ts and sample_code.ts Alternatively use JavaScript versions wabr.js, test.js and sample_code.js

Create a Reader

import modWabr = require('./wabr');

import WABarcodeReader = modWabr.WABarcodeReader;
import WABarcode = modWabr.WABarcode;
import WAUtils = modWabr.WAUtils;
....
var serverUrl: string = "";
var authorization: string = "";
var reader = new WABarcodeReader(serverUrl, authorization);

Where

• serverURL is the WABR server URL
  • It is the URL of your hosted server
  • To interact with the Inlite-hosted Test Server use the empty string to send HTTP Request to wabr.inliteresearch.com.
• authorization is a value set in Authorization field of the HTTP Request header. If authorization is an empty string, then the value is set from the WABR_AUTH environmental variable (if present).
  • For your hosted server: Use the empty string if no authentication is required, otherwise use the value expected by your IIS Authentication handler
  • For the Inlite-hosted Test Server: Use the Authorization Code supplied by Inlite. Without a valid authorization value, the Test Server returns partial results, which could be sufficient for testing the operation of your client-side code. To obtain an Authorization Code contact Inlite at sales@inliteresearch.com.

Read barcodes

Use the ReadAsync() method read barcodes asynchronously. To process both barcodes and exceptions both methods use an instance of a class derived from delReaderCallback class.

ReaderCallback(evnt: string, value, obj) {
    if (evnt == "error") {
        console.log("EXCEPTION: " + value);
    }
    else if (evnt == "barcodes") {
        // Process barcode reading results in value representing WABarcode[]
    }
}
...

var callback: delReaderCallback = this.ReaderCallback;
reader.ReadAsync(image, callback, image, types, directions, tbr_code);

Parameters

• image_source is a required parameter that points to the image(s) that the WABR server will read. The following formats are accepted.

  • URL of Internet-based file. The name should start with http:// , https:// or file://. Examples:

    https://wabr.inliteresearch.com/SampleImages/1d.pdf
    ttp://upload.wikimedia.org/wikipedia/commons/0/07/Better_Sample_PDF417.png

  • Path of a file located on or accessible from the client.   Examples:

    c:/image_folder/some_image_file.tif
    \\COMPUTER_NAME\another_folder\another_file.pdf

  • Base64-encoded string representing content of an image file.   Format:

    [ data:[<MIME-type>][;base64],]<content>[:::<filename>]

    Example:

    ``` data:application/pdf;base64,WTTVKM3OWFKFMERCMT5... :::IMAGE_FILE.PDF ``` The values in **[ ]** are optional. The values in **< >** are variables. NOTE: Neither **[ ]** nor **< >** should be included in `image_source` string.
    `content` is the only *required* value. It is an image file content encoded as base64.
    `filename` is a value assigned to `WABarcode.File` property of each barcode. Default is an empty string.
    `MIME-type` identifies file format. e.g. `application/pdf` or `image/tiff`. The value is only for compatibility with data URI scheme. The Barcode reader will automatically identify file format based on content.