Gathering detailed insights and metrics for dynamsoft-barcode-reader-bundle
Gathering detailed insights and metrics for dynamsoft-barcode-reader-bundle
Dynamsoft Barcode Reader JavaScript SDK for package managers. PDF417, QR Code, DataMatrix, MaxiCode and more are supported.
11.0.3000
178
NOASSERTION
24.35 MB
Installations
npm install dynamsoft-barcode-reader-bundleDeveloper Guide
BETA
Typescript
Yes
Module System
ESM
Node Version
16.20.1
NPM Version
8.19.4
Developer
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
GitHub Statistics
NOASSERTION License
178 Stars
113 Commits
108 Forks
12 Watchers
9 Branches
10 Contributors
Updated on Jul 10, 2025
Maintainers
1
Package Meta Information
Latest Version
11.0.3000
Package Id
dynamsoft-barcode-reader-bundle@11.0.3000
Unpacked Size
24.35 MB
Size
9.89 MB
File Count
42
NPM Version
8.19.4
Node Version
16.20.1
Published on
Jul 09, 2025
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dev Dependencies
21
@dynamsoft/dynamsoft-barcode-reader@dynamsoft/dynamsoft-camera-enhancer@dynamsoft/dynamsoft-capture-vision-router@dynamsoft/dynamsoft-code-parser@dynamsoft/dynamsoft-license@dynamsoft/dynamsoft-utility@dynamsoft/rd2-scripts@rollup/plugin-node-resolve@rollup/plugin-replace@rollup/plugin-terser@rollup/plugin-typescript@scannerproxy/curscript-path@scannerproxy/dlsjs@types/nodedynamsoft-coremutable-promiserolluprollup-plugin-dtstersertslibtypescript
Build a Web-Based Barcode Scanner Using Just a Few Lines of JavaScript
This user guide provides a step-by-step walkthrough of a "Hello World" web application using the BarcodeScanner JavaScript Edition.
The BarcodeScanner class offers the following features:
-
High-level APIs that deliver core functionality with a single line of code.
-
Pre-built UI components for fast and easy integration.
-
Intuitive configuration objects that streamline both algorithm and UI setup.
We recommend using this guide as a reference when creating your own application. If you are looking for a fully customizable barcode decoding library, you are welcome to use the Foundational APIs. Before starting, ensure the basic requirements are met.
- Internet connection
- A supported browser
- Camera access
[!TIP] Please refer to system requirements for more details.
License
Trial License
When getting started with Barcode Scanner, we recommend getting your own 30-day trial license
[!IMPORTANT] The trial license can be renewed via the customer portal twice, each time for another 15 days, giving you a total of 60 days to develop your own application using the solution. Please contact the Dynamsoft Support Team if you need more time for a full evaluation.
Full License
If you are fully satisfied with the solution and would like to move forward with a full license, please contact the Dynamsoft Sales Team.
Quick Start: Hello World Example
1<!DOCTYPE html> 2<html lang="en"> 3 <body> 4 <script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.0.3000/dist/dbr.bundle.js"></script> 5 <script> 6 // Initialize the Dynamsoft Barcode Scanner 7 const barcodeScanner = new Dynamsoft.BarcodeScanner({ 8 // Please don't forget to replace YOUR_LICENSE_KEY_HERE 9 license: "YOUR_LICENSE_KEY_HERE", 10 }); 11 (async () => { 12 // Launch the scanner and wait for the result 13 const result = await barcodeScanner.launch(); 14 // Display the first detected barcode's text in an alert 15 if (result.barcodeResults.length) { 16 alert(result.barcodeResults[0].text); 17 } 18 })(); 19 </script> 20 </body> 21</html>
Step 1: Setting up the HTML and Including the Barcode Scanner
As outlined earlier, this guide will help you create a simple Hello World barcode scanning application using vanilla JavaScript. The full sample code is also available in the GitHub repository.
The first step before writing the code is to include the SDK in your application. You can simply include the SDK by using the precompiled script.
1<!DOCTYPE html> 2<html lang="en"> 3 <body> 4 <script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.0.3000/dist/dbr.bundle.js"></script> 5 </body> 6</html>
In this example, we include the precompiled Barcode Scanner SDK script via public CDN in the header.
Use a public CDN
The simplest way to include the SDK is to use either the jsDelivr or UNPKG CDN.
-
jsDelivr
1<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.0.3000/dist/dbr.bundle.js"></script> -
UNPKG
1<script src="https://unpkg.com/dynamsoft-barcode-reader-bundle@11.0.3000/dist/dbr.bundle.js"></script>
When using a framework such as React, Vue or Angular, we recommend adding the package as a dependency using a package manager such as npm or yarn:
1npm i dynamsoft-barcode-reader-bundle@11.0.3000 2# or 3yarn add dynamsoft-barcode-reader-bundle@11.0.3000
As for package managers like npm or yarn, you likely need to specify the location of the engine files as a link to a CDN. Please see the BarcodeScannerConfig API for a code snippet on how to set the engineResourcePaths.
Host the SDK yourself
Alternatively, you may choose to download the SDK and host the files on your own server or preferred CDN. This approach provides better control over versioning and availability.
-
From the website
Download Dynamsoft Barcode Reader JavaScript Package
The resources are located in the
./dist/directory. -
From npm
1npm i dynamsoft-barcode-reader-bundle@11.0.3000The resources are located at the path
node_modules/<pkg>, without@<version>. You can copy it elsewhere and add@<version>tag.[!IMPORTANT] Since "node_modules" is reserved for Node.js dependencies, and in our case the package is used only as static resources, we recommend either renaming the "node_modules" folder or moving the "dynamsoft-" packages to a dedicated folder for static resources in your project to facilitate self-hosting.
You can typically include SDK like this:
1<script src="path/to/dynamsoft-barcode-reader-bundle@11.0.3000/dist/dbr.bundle.js"></script>
Barcode Scanner comes with a Ready-to-Use UI. When the Barcode Scanner launches, it creates a container which it populates with the Ready-to-Use UI.
Step 2: Initializing the Barcode Scanner
1// Initialize the Dynamsoft Barcode Scanner
2const barcodescanner = new Dynamsoft.BarcodeScanner({
3 // Please don't forget to replace YOUR_LICENSE_KEY_HERE
4 license: "YOUR_LICENSE_KEY_HERE",
5});This is the simplest way to initialize the Barcode Scanner. The configuration object must include a valid license key. Without it, the scanner will fail to launch and display an error. For help obtaining a license, see the licensing section.
[!TIP] By default, the
BarcodeScannerscans a single barcode at a time. However, it also supports aMULTI_UNIQUEscanning mode, which continuously scans and accumulates unique results in real time. You can enable this mode by modifying theBarcodeScannerConfigas follows:
1// Initialize the Dynamsoft Barcode Scanner in MULTI_UNIQUE mode
2const barcodescanner = new Dynamsoft.BarcodeScanner({
3 license: "YOUR_LICENSE_KEY_HERE",
4 scanMode: Dynamsoft.EnumScanMode.SM_MULTI_UNIQUE,
5});Step 3: Launching the Barcode Scanner
1(async () => { 2 // Launch the scanner and wait for the result 3 const result = await barcodescanner.launch(); 4 // Display the first detected barcode's text in an alert 5 if (result.barcodeResults.length) { 6 alert(result.barcodeResults[0].text); 7 } 8})();
Now that the Barcode Scanner has been initialized and configured, it is ready to be launched! Upon launch, the Barcode Scanner presents the main BarcodeScannerView UI in its container on the page, and is ready to start scanning. By default, we use the SINGLE scanning mode, which means only one decoding result will be included in the final result. In the code above, we directly alerted the successfully decoded barcode text on the page.
[!NOTE] In the Hello World sample, after a successfully decoding process, the scanner closes and the user is met with an empty page. In order to open the scanner again, the user must refresh the page. You may choose to implement a more user-friendly behavior in a production environment, such as presenting the user with an option to re-open the Barcode Scanner upon closing it.
Next Steps
Now that you've implemented the basic functionality, here are some recommended next steps to further explore the capabilities of the Barcode Scanner
- Learn how to Customize the Barcode Scanner
- Check out the Official Samples and Demo
- Learn about the APIs of BarcodeScanner
No vulnerabilities found.
No security vulnerabilities found.