What is Barcode Xpress

Barcode Xpress for Node.js enables developers to add the ability to read common industry 1D and 2D barcodes in their applications.

• Barcode Types - recognize over 30 different types of barcodes.
• Structured Results - results are organized in a hierarchical model where every barcode has a value, type, confidence, and location.
• Simple - by providing only a minimal asynchronous API, Barcode Xpress is easy to learn. With a few lines of code, recognize barcodes found in images produced by scanners, cameras, or fax machines.

Getting Started

1. Make sure you have the following system requirements:
   • Windows x64 operating systems of the following versions:
     • Windows 8.1
     • Windows 10
     • Windows Server 2012 (and R2)
     • Windows Server 2016
     • Windows Server 2019
   • Linux x64 operating systems of the following versions:
     • Ubuntu 18.04
     • Ubuntu 20.04
     • CentOS 7
     • CentOS 8
     • Debian 9
     • Debian 10
   • Node.js versions 12, 14, 16 and npm (to check the version use the following command: node -v)
2. Clone and run the Hello Barcode Xpress for Node.js Sample

Although Barcode Xpress for Node.js may run, it is not supported on earlier operating system versions (for example, Ubuntu 14.04 or Windows 7).

Reading Barcodes

1// Import packages.
2const bx = require("barcode-js");
3
4// Set up logging function.
5const logResults = (results) => console.log(JSON.stringify(results, ["type", "value", "confidence"], 2));
6
7// Set up analysis function.
8const analyzeBarcodes = async (filePath) => {
9    try {
10        const results = await bx.analyze(filePath);
11        logResults(results);
12    }
13    catch(err) {
14        console.error(`Fatal: Error analyzing image input\n${err}`);
15    }
16};
17
18// Set up parameters.
19// Accepted file types are bmp, tiff, jpg, gif, png, and url
20const filePath = "test.bmp";
21
22// Call analyze.
23analyzeBarcodes(filePath);

Accessing Results

The analyze method returns an array of result objects.

Each result object has the following structure:

1{
2    "type": barcodeType,
3    "value": barcodeValue,
4    "area": {
5        "x": xCoordinateBarcodeStart,
6        "y": yCoordinateBarcodeStart,
7        "height": barcodeHeight,
8        "width": barcodeWidth
9    },
10    "corners": [
11    {
12        "x": xCoordinateTopLeft,
13        "y": yCoordinateTopLeft
14    },
15    {
16        "x": xCoordinateTopRight,
17        "y": yCoordinateTopRight
18    },
19        {
20        "x": xCoordinateBottomRight,
21        "y": yCoordinateBottomRight
22    },
23        {
24        "x": xCoordinateBottomLeft,
25        "y": yCoordinateBottomLeft
26    }
27    ],
28    "confidence": recognitionConfidence
29}

For example, to get the confidence of a recognized barcode:

1const barcodeValue = result.confidence;

or to get the height property of a recognized barcode:

1const barcodeHeight = result.area.height;

Licensing

Barcode Xpress for Node.js comes with an evaluation license pre-installed, so you can get started right away.

For development and deployment licenses, and more information on licensing in general, please visit our online documention at https://help.accusoft.com/BarcodeXpress/v14.1/BxNodeJs/webframe.html.

In order to run the license manager, you will need:

• java -version JRE 1.8 or later.

More Documentation and Support

Barcode Xpress also includes detailed API documentation and a Getting Started guide.

• Need more documentation? Check out the User's Guide: https://help.accusoft.com/BarcodeXpress/v14.1/BxNodeJs/webframe.html

• Need help? Contact Accusoft at sales@accusoft.com.