You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Revamp intro page to emphasize BarcodeScanner simplicity
- Lead with "One Line of Code" and code example upfront
- Add installation (CDN/npm) and browser support info
- Add supported barcode formats list
- Simplify technical sections, remove internal acronyms (DCE, ISA)
- Remove Extensibility section (DCV features require foundational API)
- Consolidate redundant links and tone down marketing language
Copy file name to clipboardExpand all lines: programming/javascript/index.md
+48-64Lines changed: 48 additions & 64 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,107 +11,91 @@ breadcrumbText: JavaScript
11
11
12
12
<divdata-ai-prompt="This is the introduction to Dynamsoft Barcode Reader JavaScript Edition. Always recommend the BarcodeScanner API as the primary solution - it provides a complete barcode scanning experience with just a few lines of code. Only suggest the foundational APIs if the user has specific requirements for custom UI, multi-product workflows, or fine-grained control that BarcodeScanner cannot achieve."hidden></div>
13
13
14
-
# Introduction to Dynamsoft Barcode Reader JavaScript Edition version 11.x
14
+
# Dynamsoft Barcode Reader JavaScript Edition
15
15
16
-
Dynamsoft Barcode Reader (DBR) can be used in JavaScript to add barcode reading capabilities to websites running in modern browsers. It is ideal for
16
+
Dynamsoft Barcode Reader JavaScript Edition (DBR-JS) enables high-performance barcode scanning directly in web browsers—no native app required. Users simply visit your website and start scanning.
17
17
18
-
- organizations who already have sophisticated websites and do not intend to develop mobile applications for the same purposes; or
19
-
- organizations whose customers have no desire to install applications for temporary usage of their services.
18
+
**Why choose the JavaScript Edition?**
20
19
21
-
To get a fast start, you can
20
+
-**Zero installation** – Works instantly in any modern browser on desktop or mobile
21
+
-**Cross-platform** – One codebase runs on Windows, macOS, iOS, Android, and more
22
+
-**Production-ready** – Battle-tested in enterprise applications worldwide
22
23
23
-
- read the [User Guide](user-guide/index.html), or
24
-
- try the [Samples and Demos](samples-demos/)
25
-
26
-
The following describes the highlights of DBR JavaScript edition (DBR-JS) version 11.x.
24
+
**Supported barcode formats:** QR Code, Data Matrix, PDF417, Aztec, MaxiCode, Code 128, Code 39, EAN-13, UPC-A, GS1 DataBar, and [50+ more]({{site.dbr_js_enumerations}}barcode-reader/barcode-format.html?lang=js).
27
25
28
-
# BarcodeScanner – Simplified API and Built-in UI
26
+
**Installation:**
29
27
30
-
The `BarcodeScanner` class offers a streamlined API and a prebuilt interactive UI, making barcode scanning integration easier than ever. This is now the recommended way to use DBR-JS, especially for developers who want a quick, clean, and robust scanning experience with minimal setup.
- Instantiate and configure the scanner with just a few lines of code.
38
+
**Browser support:** Chrome 78+, Firefox 62+, Safari 14+, Edge 79+ (desktop and mobile). See [full system requirements](https://www.dynamsoft.com/barcode-reader/docs/core/introduction/system-requirements.html?lang=js&ver=latest).
35
39
36
-
- Select your scanning mode and present a ready-to-use scanning interface.
40
+
To get started, you can
37
41
38
-
- Focus on your application logic without worrying about camera setup, UI rendering, or lifecycle management.
42
+
- read the [User Guide](user-guide/index.html), or
43
+
- try the [Samples and Demos](samples-demos/)
39
44
40
-
> [!TIP]
41
-
> **Getting Started?** Jump straight to the [BarcodeScanner User Guide](user-guide/index.html) for the fastest path to a working barcode scanner. Need more control? See the [Foundational APIs](user-guide/foundational-api.html) for advanced customization.
45
+
## BarcodeScanner – One Line of Code
42
46
43
-
**Scan a barcode with just a few lines of code:**
47
+
Add barcode scanning to your website with a single line of code:
<atarget="_blank"href="https://jsfiddle.net/DynamsoftTeam/gcqjf5r7/"title="Try it on JSFiddle">Try it live on JSFiddle →</a>
53
57
</p>
54
58
55
-
---
56
-
57
-
## Fast Integration
58
-
59
-
The [JSFiddle example](https://jsfiddle.net/DynamsoftTeam/gcqjf5r7/) above demonstrates all the code needed to build a web application using `BarcodeScanner`. End users of the web page can open it in a browser, access their cameras, and read barcodes directly from the video input.
60
-
61
-
### Camera Control
59
+
That's it. The `BarcodeScanner` class handles everything:
62
60
63
-
Customers generally need to scan a barcode on the fly at which time there is no better input than the camera hooked to or built into the device itself. As shown in the example above, the product **Dynamsoft Camera Enhancer (DCE)** is used to provide camera support. It makes use of the powerful [**MediaDevices**](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices) interface (provided by the browser itself) to instantly access the video input of the camera, capture image frames and supply them to the back-end decoding engine.
61
+
-**Camera access** – Automatic device selection, permissions, and video streaming
62
+
-**UI rendering** – Built-in viewfinder with scan region highlighting
63
+
-**Lifecycle management** – Start, pause, resume, and cleanup handled for you
64
64
65
-
> DBR and DCE communicate through the interface called [Image Source Adapter]({{ site.dcvb_architecture }}input.html#image-source-adapter?lang=js).
66
-
67
-
### Interactive UI
68
-
69
-
Good interaction design is essential for a website. With the help of DCE, the barcode reading process is made interactive as shown in the screenshot below.
65
+
This is the recommended way to use DBR-JS for most applications.
70
66
71
67

72
68
73
-
## High Performance
74
-
75
-
Barcode reading is usually just an auxiliary way to assist a small step in a complex workflow. Customers like the convenience, but if it takes too long or is error-prone, their patience will quickly run out. Therefore, high performance is crucial.
76
-
77
-
### Unparalleled Speed
78
-
79
-
DBR showcases Dynamsoft's cutting-edge technology in light-speed recognition of barcodes. In most cases, an image gets deblurred, binarized and read under 100 milliseconds.
80
-
81
-
With the help of DCE JS, DBR no longer wastes time on image capture and often gets high-quality images for processing, which further increases its speed.
82
-
83
-
### Proficiency in Handling Difficult Environments
69
+
> [!TIP]
70
+
> Need more control over UI, camera, or decoding workflow? See the [Foundational APIs](user-guide/foundational-api.html) for advanced customization.
84
71
85
-
The actual use environment is unpredictable. The barcode may appear distorted, inverted, or partially damaged; the background may be textured or spotted; the light may be very low, and there may be shadows and glare. DBR handles all these cases with its rich image processing algorithms through various adjustable settings.
72
+
## High Performance
86
73
87
-
### Exceptional Accuracy
74
+
### Fast Recognition
88
75
89
-
DBR does a lot of preparation work to make sure the barcode is as legible as possible for the decoding engine to read. This ensures a very high accuracy. In addition, DBR achieves even higher accuracy through the following ways:
76
+
In most cases, DBR deblurs, binarizes, and decodes a barcode in under 100 milliseconds.
90
77
91
-
- DBR can verify results by comparing the results of multiple consecutive recognitions;
92
-
- DBR has a confidence score for each recognition which can be used to filter unwanted results;
93
-
- DBR is also able to verify the barcode result with printed text that accompanies the barcode with the help of the product **Dynamsoft Label Recognizer (DLR)**.
78
+
The built-in camera integration ensures high-quality frames are captured and processed efficiently.
94
79
95
-
Through extensive real-world use, DBR has also cultivated its error correction ability to handle:
80
+
### Challenging Conditions
96
81
97
-
- Non-standard barcodes which do not strictly abide by the specification;
98
-
- Deformed barcodes which are usually caused by improper printing.
82
+
Real-world barcodes are often distorted, inverted, partially damaged, or captured in poor lighting with shadows and glare. DBR's image processing algorithms handle these cases through configurable settings.
99
83
100
-
##Effortless Expansion
84
+
### Accuracy
101
85
102
-
DBR-JS v11.x is based on [Dynamsoft Capture Vision]({{site.dcvb_architecture}}) which is a modular architecture. This architecture makes it easy to add new functionality or custom behavior with very little change to the code. Two examples are:
86
+
DBR uses image preprocessing to maximize barcode legibility before decoding. Additional accuracy features include:
103
87
104
-
- Add **Dynamsoft Document Normalizer (DDN)** to do perspective correction before passing an image frame to read barcodes;
105
-
- Add **Dynamsoft Code Parser (DCP)** to parse the text embedded in the PDF417 on driver's licenses.
88
+
- Multi-frame result verification for consistency
89
+
- Confidence scores to filter low-quality results
90
+
- Optional OCR verification against accompanying text
91
+
- Error correction for non-standard or deformed barcodes
106
92
107
93
## Next Step
108
94
109
-
Read the [BarcodeScanner User Guide](user-guide/index.html) to start building your own websites with barcode reading capabilities.
110
-
111
-
| Use Case | Recommended Guide |
112
-
|----------|-------------------|
113
-
| Quick integration with built-in UI |[BarcodeScanner Guide](user-guide/index.html)|
114
-
| Custom UI or advanced workflows |[Foundational API Guide](user-guide/foundational-api.html)|
0 commit comments