Dev Center
Table of contents

JavaScript API Reference

The Dynamsoft Barcode Reader JavaScript library comes with two primary classes: BarcodeReader and BarcodeScanner.

BarcodeReader

A low-level barcode reader that processes still images and returns barcode results. The following code snippet shows its basic usage:

let reader = await Dynamsoft.DBR.BarcodeReader.createInstance();
let results = await reader.decode(imageSource);
for(let result of results){
  console.log(result.barcodeText);
}

The APIs for this class include:

Create and Destroy Instances

API Name Description
createInstance() Creates a BarcodeReader instance.
destroyContext() Destroys the BarcodeReader instance.
isContextDestroyed() Returns whether the instance has been destroyed.

Decode Barcodes

API Name Description
decode() Decodes barcodes from an image.
decodeBase64String() Decodes barcodes from a base64-encoded image (with or without MIME).
decodeUrl() Decodes barcodes from an image specified by its URL.
decodeBuffer() Decodes barcodes from raw image data.

Change Settings

API Name Description
getRuntimeSettings() Returns the current runtime settings.
updateRuntimeSettings() Updates runtime settings with a given struct or a preset template.
resetRuntimeSettings() Resets all parameters to default values.
getModeArgument() Returns the argument value for the specified mode parameter.
setModeArgument() Sets the argument value for the specified mode parameter.

Auxiliary

API Name Description
ifSaveOriginalImageInACanvas Whether to save the original image into a <canvas> element.
getOriginalImageInACanvas() Returns an HTMLCanvasElement that holds the original image.


BarcodeScanner

A barcode scanner object gets access to a camera via the MediaDevices interface, then uses its built-in UI to show the camera input and performs continuous barcode scanning on the incoming frames.

The default built-in UI of each barcode scanner is defined in the file dbr.scanner.html and it fits the entire page and sits on top. Read more on how to Customize the UI.

Although a barcode scanner is designed to scan barcodes from a video input, it also supports a special mode called singleFrameMode which allows users to select a still image or take a shot with the camera for barcode scanning.

The following code snippet shows the basic usage of the BarcodeScanner class.

let scanner = await Dynamsoft.DBR.BarcodeScanner.createInstance();
scanner.onUnduplicatedRead = txt => console.log(txt);
await scanner.show();

The BarcodeScanner is a child class of BarcodeReader and inherits all its methods and properties. APIs not directly inherited include:

Create and Destroy Instances

API Name Description
createInstance() Creates a BarcodeScanner instance.
destroyContext() Destroys the BarcodeScanner instance.
isContextDestroyed() Returns whether the instance has been destroyed.

Decode Barcodes

API Name Description
onUnduplicatedRead This event is triggered when a new, unduplicated barcode is found.
onFrameRead This event is triggered after the library finishes scanning a frame.

Basic Interaction

API Name Description
show() Binds and shows UI, opens the camera and starts decoding.
hide() Stops decoding, releases camera, hides and unbinds UI.
open() Binds UI, opens the camera and starts decoding. Meant for use with frameworks like Angular, Vue, React.
close() Stops decoding, releases camera and unbinds UI. Meant for use with frameworks like Angular, Vue, React.

Scan Settings

API Name Description
whenToPlaySoundforSuccessfulRead Sets when to play sound on barcode recognition.
soundOnSuccessfullRead Specifies the sound to play on barcode recognition.
whenToVibrateforSuccessfulRead Sets when to vibrate on barcode recognition.
vibrateDuration Returns or sets how long the vibration lasts in milliseconds.
singleFrameMode Returns or sets whether to enable the singe-frame mode.
getScanSettings() Returns the current scan settings.
updateScanSettings() Changes scan settings with the object passed in.

UI Control

API Name Description
getUIElement() Returns the HTML element that is used by the BarcodeScanner instance.
setUIElement() Specifies an HTML element for the BarcodeScanner instance to use as its UI.
defaultUIElementURL Returns or sets the URL of the .html file that defines the default UI Element.
barcodeFillStyle Specifies the color used inside the shape which highlights a found barcode.
barcodeStrokeStyle Specifies the color used to paint the outline of the shape which highlights a found barcode.
barcodeLineWidth Specifies the line width of the outline of the shape which highlights a found barcode.
regionMaskFillStyle Specifies the color used in the square-loop shape between the actual scanning area and the boundary of the video input.
regionMaskStrokeStyle Specifies the color used to paint the outline of the scanning region.
regionMaskLineWidth Specifies the width of the outline of the scanning region.

Camera Control

API Name Description
getAllCameras() Returns infomation of all available cameras on the device.
getCurrentCamera() Returns information about the current camera.
setCurrentCamera() Chooses a camera as the video source.
getResolution() Returns the resolution of the current video input.
setResolution() Sets the resolution of the current video input.
getVideoSettings() Returns the current video settings.
updateVideoSettings() Changes the video input.

Video Decoding Process Control

API Name Description
play() Play the video if it is already open but paused or stopped.
onPlayed This event is triggered when the video stream starts playing.
pauseScan() Pauses the decoding process.
resumeScan() Resumes the decoding process.
pause() Pauses the video without releasing the camera.
stop() Stops the video and releases the camera.

Advanced Camera Control

API Name Description
getCapabilities() Inspects and returns the capabilities of the current camera.
getCameraSettings() Returns the current values for each constrainable property of the current camera.
setFrameRate() Adjusts the frame rate.
setColorTemperature() Adjusts the color temperature.
setExposureCompensation() Sets the exposure compensation index.
setZoom() Sets the exposure compensation index.
turnOnTorch() Turns on the torch/flashlight.
turnOffTorch() Turns off the torch/flashlight.

License Control

The library provides flexible licensing options with the support of the following APIs:

Deprecated APIs:

Initialization Control

The following static methods and properties help to set up the runtime environment for the library:

Interfaces and Enums

In order to make the code more predictable and readable, the library defines a series of supporting interfaces and enumerations:

Interfaces

Enums

This page is compatible for:

Is this page helpful?

YesYes NoNo

In this article: