Browse our Products

Aspose.BarCode for Node.js via Java 26.7

All Changes

KeySummaryCategory
BARCODEJS-694Align the Aspose.BarCode for Node.js public API with Node.js conventionsEnhancement
BARCODEJS-750Modernize the Aspose.BarCode for Node.js via Java integration with support for modern Node.js versionsEnhancement
BARCODENET-39571Pdf417 cannot be recognized from the imageBug
BARCODENET-39579Improve QR encodingEnhancement

Public API changes and New Features

Changed packages and classes structure

Java class loading, classpath configuration, and JVM initialization are now handled by a dedicated internal bridge layer.

The JavaScript wrapper has also been reorganized. Instead of several large wrapper files, individual API types are now implemented in separate modules grouped by functionality:

  • generation – barcode generation classes, parameters, builders, and enumerations
  • recognition – barcode recognition classes, settings, results, and enumerations
  • complexBarcode – complex barcode generation and decoding classes
  • License – product licensing
  • BarcodeException – barcode-specific errors

How to import classes

The root package export has changed.

The previous API exposed the AsposeBarcode object containing most classes directly:

const barcode = require("aspose.barcode");
const asposeBarcode = barcode.AsposeBarcode;

const BarcodeGenerator = asposeBarcode.BarcodeGenerator;
const EncodeTypes = asposeBarcode.EncodeTypes;
const BarCodeReader = asposeBarcode.BarCodeReader;
const DecodeType = asposeBarcode.DecodeType;

The new API exposes the asposebarcode object and groups the API into functional namespaces:


const { asposebarcode } = require("aspose.barcode");

const {
    BarcodeGenerator,
    EncodeTypes,
    BarCodeImageFormat
} = asposebarcode.generation;

const {
    BarCodeReader,
    DecodeType
} = asposebarcode.recognition;

const {
    ComplexBarcodeGenerator,
    ComplexCodetextReader
} = asposebarcode.complexBarcode;

const {
    License,
    BarcodeException
} = asposebarcode;

Applications using the previous AsposeBarcode root object must update their imports.

Removed legacy root-level exports

Generation, recognition, and complex barcode classes are no longer exported directly from the root AsposeBarcode object.

The following internal and bridge-specific exports are also no longer part of the public root API:

  • generation_
  • recognition_
  • complexbarcode_
  • joint_
  • jar_name_
  • jar_path_
  • BuildVersionInfo
  • Rectangle
  • Point

Applications should use the corresponding public namespaces and plain JavaScript geometry objects.

Plain JavaScript geometry support

Recognition areas and geometry values can now be represented by plain JavaScript objects.

A rectangle can be specified as an object:

const { asposebarcode } = require("aspose.barcode");

const {
    BarCodeReader,
    DecodeType
} = asposebarcode.recognition;

const recognitionArea = {
    x: 0,
    y: 0,
    width: 500,
    height: 300
};

const reader = new BarCodeReader(
    "test.png",
    [recognitionArea],
    DecodeType.ALL_SUPPORTED_TYPES
);

const results = reader.readBarCodes();

for (const result of results) {
    console.log(result.getCodeText());
}

A rectangle can also be specified as an array containing x, y, width, and height values.

Points returned by the recognition API are represented by objects containing x and y properties. Rectangles returned by the API contain x, y, width, and height properties.

Improved UTF-8 codetext conversion

Codetext passed to the BarcodeGenerator constructor is now explicitly converted to a Java UTF-8 string by the bridge layer.

This improves the transfer of Unicode codetext between Node.js and Java, particularly for QR, DataMatrix, Aztec, PDF417, MaxiCode, and other 2D barcode types.

Improved PDF417 barcode recognition quality

The recognition quality of PDF417 barcodes has been improved, particularly for blurred and highly distorted images.

const fileName = "example1.png";
const filePath = folder + fileName;
const generator = new BarcodeGenerator(EncodeTypes.PDF_417,"ASPOSE");
generator.save(filePath, BarCodeImageFormat.PNG);
const reader = new BarCodeReader(filePath, null, DecodeType.PDF_417);
const results = reader.readBarCodes();
for (const result of results)
{
    console.log("BarCode CodeType: " + result.getCodeTypeName());
    console.log("BarCode CodeText: " + result.getCodeText());
}

New EncodeGS1SeparatorInByteMode option

Added the EncodeGS1SeparatorInByteMode option to the QR encoder for the GS_1_QR symbology.

Added methods:

  • setEncodeGS1SeparatorInByteMode(boolean value)
  • getEncodeGS1SeparatorInByteMode()

to the generation.QrParameters class.

When enabled, GS1 group separators and the % character are encoded in Byte mode instead of using the QR Alphanumeric representation. This option improves compatibility with legacy barcode decoders that expect the GS1 group separator to be encoded as the 0x1D byte.

const fileName = "example2.png";
const filePath = folder + fileName;
const generator = new BarcodeGenerator(EncodeTypes.GS_1_QR,"(10)ASPOSE2001(21)ASPOSE2026");
generator.getParameters().getBarcode().getQR().setEncodeGS1SeparatorInByteMode(true);
generator.save(filePath, BarCodeImageFormat.PNG);
const reader = new BarCodeReader(filePath, null, DecodeType.GS_1_QR);
const results = reader.readBarCodes();
for (const result of results)
{
    console.log("BarCode CodeType: " + result.getCodeTypeName());
    console.log("BarCode CodeText: " + result.getCodeText());
}

New compaction mode support in QrExtCodetextBuilder

The generation.QrExtCodetextBuilder class has been extended with support for explicit QR compaction mode selection through the QrExtCompactionMode enumeration.

Added class generation.QrExtCompactionMode.

Supported compaction modes:

  • AUTO – automatically selects the most efficient QR compaction mode.
  • NUMERIC – encodes codetext in QR Numeric mode (digits 0-9 only).
  • ALPHA_NUMERIC – encodes codetext in QR Alphanumeric mode.
  • BYTES – encodes codetext in QR Byte mode.
  • KANJI – encodes codetext in QR Kanji mode.

This feature allows manual control over the compaction mode of individual codetext fragments when generating QR barcodes in QREncodeMode.EXTENDED.

const fileName = "example3.png";
const filePath = folder + fileName;
// Build an extended QR codetext with explicitly selected compaction modes.
const textBuilder = new QrExtCodetextBuilder();
// Encode the numeric fragment in QR Numeric mode.
textBuilder.addCodetextWithCompactionMode(QrExtCompactionMode.NUMERIC, "1234567");
// Encode the uppercase fragment in QR Alphanumeric mode.
textBuilder.addCodetextWithCompactionMode(QrExtCompactionMode.ALPHA_NUMERIC, "ASPOSE2026");
// Encode the lowercase fragment in QR Byte mode.
textBuilder.addCodetextWithCompactionMode(QrExtCompactionMode.BYTES, "aspose2026");
// Encode the Japanese fragment in QR Kanji mode.
textBuilder.addCodetextWithCompactionMode(QrExtCompactionMode.KANJI, "ぢっつづてでとどな");
const codetext = textBuilder.getExtendedCodetext();
const generator = new BarcodeGenerator(EncodeTypes.QR,codetext);
generator.getParameters().getBarcode().getQR().setEncodeMode(QREncodeMode.EXTENDED);
generator.save(filePath, BarCodeImageFormat.PNG);
const reader = new BarCodeReader(filePath, null, DecodeType.GS_1_QR);
const results = reader.readBarCodes();
for (const result of results)
{
    console.log("BarCode CodeType: " + result.getCodeTypeName());
    console.log("BarCode CodeText: " + result.getCodeText());
}

The BYTES compaction mode can also be used to encode the entire codetext in QR Byte mode:

const fileName = "example4.png";
const filePath = folder + fileName;
const textBuilder = new QrExtCodetextBuilder();
// Force the entire codetext to be encoded in QR Byte mode.
textBuilder.addCodetextWithCompactionMode(QrExtCompactionMode.BYTES, "1234567890ASPOSE2026aspose2026");
const codetext = textBuilder.getExtendedCodetext();

const generator = new BarcodeGenerator(EncodeTypes.QR,codetext);
generator.getParameters().getBarcode().getQR().setEncodeMode(QREncodeMode.EXTENDED);
generator.save(filePath, BarCodeImageFormat.PNG);
const reader = new BarCodeReader(filePath, null, DecodeType.GS_1_QR);
const results = reader.readBarCodes();
for (const result of results)
{
    console.log("BarCode CodeType: " + result.getCodeTypeName());
    console.log("BarCode CodeText: " + result.getCodeText());
}

New compaction mode support in QREncodeMode.EXTENDED

The QREncodeMode.EXTENDED encoding mode has been extended with support for explicit QR compaction mode selectors.

Supported compaction mode selectors:

  • \auto – automatically selects the most efficient QR compaction mode.
  • \num – encodes subsequent codetext in QR Numeric mode.
  • \alnum – encodes subsequent codetext in QR Alphanumeric mode.
  • \byte – encodes subsequent codetext in QR Byte mode.
  • \kanji – encodes subsequent codetext in QR Kanji mode.

This feature allows manual control over the compaction mode of individual codetext fragments.

const fileName = "example5.png";
const filePath = folder + fileName;
// Use explicit QR compaction mode selectors and then switch back to automatic mode.
const codetext = "\\num1234567890\\alnumASPOSE2026\\byteaspose2026\\kanjiぢっつづてでとどな\\auto123ABCabc";

const generator = new BarcodeGenerator(EncodeTypes.QR,codetext);
generator.getParameters().getBarcode().getQR().setEncodeMode(QREncodeMode.EXTENDED);
generator.save(filePath, BarCodeImageFormat.PNG);
const reader = new BarCodeReader(filePath, null, DecodeType.GS_1_QR);
const results = reader.readBarCodes();
for (const result of results)
{
    console.log("BarCode CodeType: " + result.getCodeTypeName());
    console.log("BarCode CodeText: " + result.getCodeText());
}

The \byte selector can be used to encode the entire codetext in QR Byte mode:

const fileName = "example6-NODEJS.png";
const filePath = ReleaseNotes.folder + fileName;
const codetext = "\\byte1234567890ASPOSE2026aspose2026";

const generator = new BarcodeGenerator(EncodeTypes.QR,codetext);
generator.getParameters().getBarcode().getQR().setEncodeMode(QREncodeMode.EXTENDED);
generator.save(filePath, BarCodeImageFormat.PNG);
const reader = new BarCodeReader(filePath, null, DecodeType.GS_1_QR);
const results = reader.readBarCodes();
for (const result of results)
{
    console.log("BarCode CodeType: " + result.getCodeTypeName());
    console.log("BarCode CodeText: " + result.getCodeText());
}