Release Notes for Dynamsoft Barcode Reader JavaScript SDK
10.5.3000 (04/24/2025)
New
- Introduced BarcodeScanner class
- Offers high-level APIs that provide core functionalities
- Includes pre-built UI for fast and seamless integration
- Features intuitive configuration objects to simplify both algorithm and UI setup
Improved
- Merged resource files previously required by the Barcode-Reader-Bundle, significantly reduced the overall size of the
.wasmfile
10.4.3100 (01/03/2025)
New
- Added the
ShortlineDetectionModeandLineAssemblyModeparameters for more flexible and precise configuration. - Added the
getTemplateNamesfunction to theCaptureVisionRouterclass to improve accessibility and usability of templates.
Fixed
- Fixed a bug that could cause a crash when using specific templates.
- Fixed a bug in DPM mode where the
isMirroredvalue in theBarcodeResultItemwas not correctly assigned. - Fixed a bug where DotCode could not be decoded in certain scenarios.
10.4.2002 (10/24/2024)
New
-
Added support for decoding add-on codes (also known as Extension Codes) for UPC-A, UPC-E, EAN-8 and EAN-13 codes.

-
Added new properties to the
QRCodeDetailsinterface including:dataMaskPatterncodewords
Improved
- Improved the read rate and processing speed for the following barcode formats:
- EAN-13
- DotCode
Changed
- Updated the enumeration value of
EnumBarcodeFormat.BF_ALLto0xFFFFFFFEFFFFFFFF, which no longer includes non-standard barcodes.
Fixed
- Fixed a bug that could prevent the reading of
GS1_DATABAR_EXPANDED_STACKEDbarcodes.
Changes to other support modules
DynamsoftCameraEnhancer
- A new preset UI template has been added, which can be used and modified as needed.
DynamsoftCaptureVisionRouter
- Updated error handling logic for the
capturingandstartCapturingmethods to clearly report errors specifically related to licensing issues. - Added a new callback function,
OnRawTextLinesReceived, to theIntermediateResultReceiverinterface. - Added
EnumPresetTemplate, an enumeration of all preset template names.
DynamsoftCore
- Optimized the path auto-filling mechanism, now allowing the definition of only the root path without the need to separately define the resource file locations for each submodule. Read more about engineResourcePaths.
- Added new error codes
- -10076: The license is initialized successfully but detected invalid content in the key.
- -30063: [Barcode Reader] No license found.
- Added a new enumeration member
IRUT_RAW_TEXT_LINESto theEnumIntermediateResultUnitType.
DynamsoftLicense
- Introduced a new charging method,
TimeSliceCount, which tracks usage based on time. - Improved duplicate license handling: after successfully creating an instance, setting the same license again no longer causes an exception.
- Updated the error messages for the
initLicensemethod, providing more detailed feedback if license initialization fails. Warnings are now shown if the license is initialized successfully but part of the key is invalid.
DynamsoftImageProcessing
- Fixed a crash caused by the use of
RegEx.
DynamsoftUtility
- Fixed an issue where the method
CaptureVisionRouter.startCapturing()would mistakenly halt the fetching process when running, resulting in unnecessary stops and restarts.
10.2.10 (04/03/2024)
New
- Updated the template system
- Added
StringLengthRangeforTextDetectionMode. - Added Argument
BarcodeFormatforDPMCodeReadingModes. Currently, you can specify “BF_DATAMATRIX” or “BF_QR_CODE” for the parameter. - Added
ReferenceTaskNameArrayunderLocation.ReferenceObjectFilterto filter the reference objects generated by the task name. - Added the support of the
OutputTaskSettingdefinition. The following sub-parameters are available inOutputTaskSettingobject:OutputConditionTaskResultArrayTargetROIDefNameTaskSettingNameArrayBackwardReferenceOutputReferenceTaskNameArrayReferenceResultTypeArrayOperator
Offsetparameter is optimized.- Added
ReferenceObjectTypeto specify whether the reference object is an atomic object or the whole image. - Added
ReferenceXAxis&ReferenceYAxisto define the X & Y axis. - Modified
FirstPoint,SecondPoint,ThirdPoint&FourthPoint. You can specify whether the X or Y coordinate of the point is measured by percentage. - Deprecated
ReferenceObjectSizeType.
- Added
- Added
- Added the following new error codes
EC_IMAGE_SIZE_NOT_MATCHEC_IMAGE_PIXEL_FORMAT_NOT_MATCHEC_SECTION_LEVEL_RESULT_IRREPLACEABLEEC_AXIS_DEFINITION_INCORRECTEC_TEXT_LINE_GROUP_LAYOUT_CONFLICTEC_TEXT_LINE_GROUP_REGEX_CONFLICT
- Added
ObservationParametersinterface for allowing the configuration of intermediate result observation. - Added a new call back function
onShortLinesUnitReceivedto theIntermediateResultReceiverclass. - Added a new supported image pixel format, binary 8 inverted. The corresponding enumeration member is added to the
EnumImagePixelFormat. - Update
MultiFrameResultCrossFilterclass to allow string type for resultItemType. - Update
TextZonesUnitinterface, now usingTextZoneinterface to record text zone data. - Update
CandidateBarcodeZonesUnitinterface, now usingCandidateBarcodeZoneto record candidate barcode zone data instead ofQuadrilateral. - Update
DeformationResistedBarcodeImageUnitinterface, now usingDeformationResistedBarcodeinterface to record deformation resisted barcode data.
Improved
- Updated the security of the DynamsoftBarcodeReader library and other corresponding dependent libraries.
Fixed
- Fix the issue of camera not opening in iOS 17.4.
Breaking Changes
- The interface
CapturedResultis migrated fromDynamsoftCoremodule toDynamsoftCaptureVisionRoutermodule. - Changed the logic of the
capturedResultItemTypessetting ofSimplifiedCaptureVisionSettings:- If the result item types don’t match the specified template, the method
updateSettingswill return the error codeEC_PARAMETER_VALUE_INVALIDwith the message “The captured result item types do not match the task configurations in the template”. - Based on the
capturedResultItemTypessetting, the irrelevant tasks will be removed from the template. - The
capturedResultItemTypesshould include at least one of theCRIT_BARCODE,CRIT_TEXT_LINE,CRIT_DETECTED_QUAD,CRIT_NORMALIZED_IMAGE. Otherwise, the methodupdateSettingswill return the error codeEC_PARAMETER_VALUE_INVALIDwith the message “The captured result item types should contain at least one task result type”.
- If the result item types don’t match the specified template, the method
- Refactored the
Contourinterface. Please view API reference -Contourinterface for more information.
10.0.21 (02/05/2024)
Improved
- Introduced
dbr.bundle.jsto include packages that are required on running Dynamsoft Barcode Reader to reduce the complexity of the code.
10.0.20 (01/29/2024)
Changelog
In this version, the SDK has been refactored under the DynamsoftCaptureVision (DCV) architecture. To learn more about the architecture, please see Architecture of Dynamsoft Capture Vision. The following highlights the major changes:
-
The class
BarcodeReaderandBarcodeScannerare removed and its functionalities are now incorporated into the newly added ClassCaptureVisionRouter. -
License-related functions are handled by class Dynamsoft.License.LicenseManager.
- Camera-related functions are handled by DynamsoftCameraEnhancer(DCE). Please note that the following features are grouped together as enhanced features that require a license:
- Enhanced-focus.
- Auto-zoom.
- Tap-to-focus.
-
This version of
BarcodeReaderonly acceptsDynamsoftCameraEnhancer(DCE)version 4.0.1 and above, which has been refactored to be compliant with the ImageSourceAdapter (ISA) interface, as a valid image source. -
Decoded barcode results are returned via the CapturedResultReceiver (CRR) interface.
- For the full list of API changes, please refer to the v9 to v10 Upgrade Guide.