Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 58 additions & 5 deletions _includes/samples_index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1042,10 +1042,10 @@

<!-- Featured Section - Quick Start & Official Demo -->
<div class="featured-container">
<a href="https://demo.dynamsoft.com/Samples/DBR/JS/hello-world.html" class="featured-box quick-start">
<a href="https://demo.dynamsoft.com/Samples/DBR/JS/basics/hello-world.html" class="featured-box quick-start">
<span class="label">🚀 Quick Start</span>
<div class="title">Hello World - Scan Your First Barcode</div>
<div class="description">The simplest example to get started with barcode scanning in under 2 minutes</div>
<div class="title">Hello World - Scan Multiple Barcodes</div>
<div class="description">The simplest example to get started with barcode scanning. Continuously scans and collects multiple unique barcodes</div>
<span
class="guide-badge"
title="View user guide documentation"
Expand All @@ -1061,7 +1061,7 @@
<span
class="github-badge"
title="View source code on GitHub"
onclick="event.stopPropagation(); window.open('https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/hello-world.html', '_blank'); return false;"
onclick="event.stopPropagation(); window.open('https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/basics/hello-world.html', '_blank'); return false;"
>
<svg width="20" height="20" viewBox="0 0 16 16" fill="white">
<path
Expand Down Expand Up @@ -1106,6 +1106,48 @@
>
</div>

<!-- Hello World Samples -->
<div class="file">
<h3>
Hello World Samples <span class="sample-count">(3)</span>
</h3>
</div>
<div class="children">
<div class="file">
<span data-balloon-length="large" data-balloon-pos="down" aria-label="The simplest example to get started with barcode scanning. Continuously scans and collects multiple unique barcodes."
><a class="button title demo-link" href="https://demo.dynamsoft.com/Samples/DBR/JS/basics/hello-world.html" title="View live demo">Hello World (Scan Multiple Barcodes)</a
><a
class="button title source-link"
href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/basics/hello-world.html"
title="View source code on GitHub"
>Source</a
></span
>
</div>
<div class="file">
<span data-balloon-length="large" data-balloon-pos="down" aria-label="Scan and return only the first barcode detected."
><a class="button title demo-link" href="https://demo.dynamsoft.com/Samples/DBR/JS/basics/scan-a-single-barcode.html" title="View live demo">Scan a Single Barcode</a
><a
class="button title source-link"
href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/basics/scan-a-single-barcode.html"
title="View source code on GitHub"
>Source</a
></span
>
</div>
<div class="file">
<span data-balloon-length="large" data-balloon-pos="down" aria-label="Read barcodes from a static image file by uploading."
><a class="button title demo-link" href="https://demo.dynamsoft.com/Samples/DBR/JS/basics/read-an-image.html" title="View live demo">Read an Image</a
><a
class="button title source-link"
href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/basics/read-an-image.html"
title="View source code on GitHub"
>Source</a
></span
>
</div>
</div>

<!-- Framework Samples -->
<div class="file">
<h3>
Expand Down Expand Up @@ -1278,7 +1320,7 @@ <h3>
<!-- Scenario Samples -->
<div class="file">
<h3>
Scenario Samples <span class="sample-count">(17)</span>
Scenario Samples <span class="sample-count">(18)</span>
<a
class="button title readme-link section-readme-link"
href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/scenarios/README.md"
Expand All @@ -1304,6 +1346,17 @@ <h3>
></span
>
</div>
<div class="file">
<span data-balloon-length="large" data-balloon-pos="down" aria-label="Shows how to guide users with rotating tip messages on the camera view and play a beep sound on successful barcode detection.."
><a class="button title demo-link" href="https://demo.dynamsoft.com/Samples/DBR/JS/scenarios/tip-and-beep/index.html" title="View live demo">Tip and Beep</a
><a
class="button title source-link"
href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/scenarios/tip-and-beep"
title="View source code on GitHub"
>Source</a
></span
>
</div>
<div class="file">
<span data-balloon-length="large" data-balloon-pos="down" aria-label="Scan a product barcode and simulate a search from a product database."
><a class="button title demo-link" href="https://demo.dynamsoft.com/Samples/DBR/JS/scenarios/scan-and-search/index.html" title="View live demo">Scan and Search</a
Expand Down
4 changes: 2 additions & 2 deletions programming/javascript/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,12 +27,12 @@ Dynamsoft Barcode Reader JavaScript Edition (DBR-JS) enables high-performance ba

```html
<!-- CDN -->
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
```

```bash
# Or via npm
npm install dynamsoft-barcode-reader-bundle@11.4.2001
npm install dynamsoft-barcode-reader-bundle@11.4.3000
```

**Browser support:** Chrome 78+, Firefox 68+, Safari 14+, Edge 79+ (desktop and mobile). See [full system requirements](https://www.dynamsoft.com/faq/barcode-reader/web/capabilities/system-requirement.html).
Expand Down
13 changes: 2 additions & 11 deletions programming/javascript/migrate-from-v10/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ needAutoGenerateSidebar: true
To use version 11, include the following script in your HTML:

```html
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
```

## APIs changes introduced in v11
Expand Down Expand Up @@ -123,16 +123,7 @@ Dynamsoft.DCP.CodeParserModule.loadSpec("MRTD_TD2_ID");
Dynamsoft.DCP.CodeParserModule.loadSpec("MRTD");
```

**Self-hosted resource files**: If you host these files yourself, replace the old `.data` & `_Map.text` files with the new `.data` equivalents:

| Old File | New File |
| --- | --- |
| `AADHAAR.json` | `AADHAAR.data` |
| `AAMVA_DL_ID.json` | `AAMVA_DL_ID.data` |
| `GS1_AI.json` | `GS1_AI.data` |
| `MRTD.json` | `MRTD.data` |
| `SOUTH_AFRICA_DL.json` | `SOUTH_AFRICA_DL.data` |
| `VIN.json` | `VIN.data` |
**Self-hosted resource files**: If you host these files yourself, replace the old `.data` & `_Map.text` files with the new `.data` equivalents.

### Upgrade your template

Expand Down
1 change: 1 addition & 0 deletions programming/javascript/release-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ breadcrumbText: Release Notes

# DBR JavaScript SDK - Release Notes

- [11.4.3000 (07/02/2026)](js-11.html#1143000-07022026)
- [11.4.2001 (04/24/2026)](js-11.html#1142001-04242026)
- [11.4.2000 (04/21/2026)](js-11.html#1142000-04212026)
- [11.2.4000 (11/11/2025)](js-11.html#1124000-11112025)
Expand Down
4 changes: 4 additions & 0 deletions programming/javascript/release-notes/js-11.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ noTitleIndex: true

# Release Notes for Dynamsoft Barcode Reader JavaScript SDK

## 11.4.3000 (07/02/2026)

Updated third-party libraries to incorporate the latest security fixes.

## 11.4.2001 (04/24/2026)

### Fixed
Expand Down
28 changes: 14 additions & 14 deletions programming/javascript/user-guide/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ The complete code of the "Hello World" example is shown below
<body>
<div id="camera-view-container" style="width: 100%; height: 60vh"></div>
<textarea id="results" style="width: 100%; min-height: 10vh; font-size: 3vmin; overflow: auto" disabled></textarea>
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
<script>
Dynamsoft.License.LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9");
Dynamsoft.Core.CoreModule.loadWasm();
Expand Down Expand Up @@ -84,15 +84,15 @@ The complete code of the "Hello World" example is shown below
```

<p align="center" style="text-align:center; white-space: normal; ">
<a target="_blank" href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/v11.4.20/hello-world.html" title="Code in Github" style="text-decoration:none;">
<a target="_blank" href="https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/v11.4.20/basics/hello-world.html" title="Code in Github" style="text-decoration:none;">
<img src="https://cdn.jsdelivr.net/npm/simple-icons@3.0.1/icons/github.svg" alt="Code in Github" width="20" height="20" style="width:20px;height:20px;">
</a>
&nbsp;
<a target="_blank" href="https://jsfiddle.net/DynamsoftTeam/csm2f9wb/" title="Run via JSFiddle" style="text-decoration:none;">
<img src="https://cdn.jsdelivr.net/npm/simple-icons@3.0.1/icons/jsfiddle.svg" alt="Run via JSFiddle" width="20" height="20" style="width:20px;height:20px;" >
</a>
&nbsp;
<a target="_blank" href="https://demo.dynamsoft.com/Samples/DBR/JS/hello-world.html?ver=11.4.20&utm_source=guide" title="Run in Dynamsoft" style="text-decoration:none;">
<a target="_blank" href="https://demo.dynamsoft.com/Samples/DBR/JS/basics/hello-world.html?ver=11.4.20&utm_source=guide" title="Run in Dynamsoft" style="text-decoration:none;">
<img src="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6.0.0/svgs/solid/circle-play.svg" alt="Run in Dynamsoft" width="20" height="20" style="width:20px;height:20px;">
</a>
</p>
Expand Down Expand Up @@ -137,7 +137,7 @@ The complete code of the "Hello World" example is shown below

### Run the example

You can run the example deployed to [the Dynamsoft Demo Server](https://demo.dynamsoft.com/Samples/DBR/JS/hello-world.html?ver=11.4.20&utm_source=guide) or test it with [JSFiddle code editor](https://jsfiddle.net/DynamsoftTeam/csm2f9wb/).
You can run the example deployed to [the Dynamsoft Demo Server](https://demo.dynamsoft.com/Samples/DBR/JS/basics/hello-world.html?ver=11.4.20&utm_source=guide) or test it with [JSFiddle code editor](https://jsfiddle.net/DynamsoftTeam/csm2f9wb/).

You will be asked to allow access to your camera, after which the video will be displayed on the page. After that, you can point the camera at a barcode to read it.

Expand Down Expand Up @@ -170,29 +170,29 @@ The simplest way to include the SDK is to use either the [jsDelivr](https://jsde
- jsDelivr

```html
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="https://cdn.jsdelivr.net/npm/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
```

- UNPKG

```html
<script src="https://unpkg.com/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="https://unpkg.com/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
```

<!-- - In some rare cases (such as some restricted areas), you might not be able to access the CDN. If this happens, you can use the following files for the test.

```html
<script src="https://download2.dynamsoft.com/packages/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="https://download2.dynamsoft.com/packages/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
```

However, please **DO NOT** use `download2.dynamsoft.com` resources in a production application as they are for temporary testing purposes only. Instead, you can try hosting the SDK yourself. -->

- In frameworks like React, Vue and Angular, you may want to add the package as a dependency.

```sh
npm i dynamsoft-barcode-reader-bundle@11.4.2001 -E
npm i dynamsoft-barcode-reader-bundle@11.4.3000 -E
# or
yarn add dynamsoft-barcode-reader-bundle@11.4.2001 -E
yarn add dynamsoft-barcode-reader-bundle@11.4.3000 -E
```

NOTE that in frameworks, you need to [specify the location of the engine files](#2-optional-specify-the-location-of-the-engine-files).
Expand All @@ -207,12 +207,12 @@ Besides using the public CDN, you can also download the SDK and host its files o

[Download Dynamsoft Barcode Reader JavaScript Package](https://www.dynamsoft.com/barcode-reader/downloads/?ver=11.4.20&utm_source=guide&product=dbr&package=js)

The resources are located at path `dynamsoft/distributables/<pkg>@<version>`.
The resources are located at path `dynamsoft-barcode-reader-js-{version-number}/dist/`.

- From npm

```sh
npm i dynamsoft-barcode-reader-bundle@11.4.2001 -E
npm i dynamsoft-barcode-reader-bundle@11.4.3000 -E
```

The resources are located at the path `node_modules/<pkg>`, without `@<version>`. You must copy "dynamsoft-xxx" packages elsewhere and add `@<version>`. The `<version>` can be obtained from `package.json` of each package. Another thing to do is to [specify the engineResourcePaths](#2-optional-specify-the-location-of-the-engine-files) so that the SDK can correctly locate the resources.
Expand All @@ -221,7 +221,7 @@ Besides using the public CDN, you can also download the SDK and host its files o
You can typically include SDK like this:

```html
<script src="path/to/dynamsoft-barcode-reader-bundle@11.4.2001/dist/dbr.bundle.js"></script>
<script src="path/to/dynamsoft-barcode-reader-bundle@11.4.3000/dist/dbr.bundle.js"></script>
```
<div class="multi-panel-end"></div>

Expand Down Expand Up @@ -540,7 +540,7 @@ await cvRouter.startCapturing("ReadSingleBarcode");

The preset templates have many more settings that can be customized to suit your use case best. If you [download the SDK from Dynamsoft website](https://www.dynamsoft.com/barcode-reader/downloads/1000003-confirmation/), you can find the templates under

* "/dynamsoft-barcode-reader-js-11.4.2001/dist/templates/"
* "/dynamsoft-barcode-reader-js-11.4.3000/dist/templates/"

Upon completing the template editing, you can invoke the `initSettings` method and provide it with the template path as an argument.

Expand Down Expand Up @@ -642,7 +642,7 @@ The UI is part of the auxiliary SDK "Dynamsoft Camera Enhancer", read more on ho
### API Reference

You can check out the detailed documentation about the APIs of the SDK at
[https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.4.2001](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.4.2001).
[https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.4.3000](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.4.3000).

<!-- Compatibility is basically not an issue. Pls remove to another place

Expand Down
8 changes: 4 additions & 4 deletions programming/javascript/user-guide/use-in-framework.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
layout: default-layout
title: v11.4.2001 User Guide - Use Dynamsoft Barcode Reader JavaScript Edition In Framework
title: v11.4.3000 User Guide - Use Dynamsoft Barcode Reader JavaScript Edition In Framework
description: This is the user guide to integrate Dynamsoft Barcode Reader JavaScript SDK in framework.
keywords: user guide, javascript, js, barcodes, camera, images, framework, react, angular, vue
breadcrumbText: User Guide
Expand All @@ -24,7 +24,7 @@ Assuming you have an existing project using a framework, you should have a `pack
2. Install DBR-JS SDK with the following command:

```sh
npm install dynamsoft-barcode-reader-bundle@11.4.2001 -E
npm install dynamsoft-barcode-reader-bundle@11.4.3000 -E
```

3. Confirm the installation by checking the `package.json`. You should see:
Expand All @@ -34,12 +34,12 @@ Assuming you have an existing project using a framework, you should have a `pack
...
"dependencies": {
...
"dynamsoft-barcode-reader-bundle": "11.4.2001"
"dynamsoft-barcode-reader-bundle": "11.4.3000"
}
}
```

Notice that there is no `^` before `11.4.2001`. No `^` indicates an exact version, ensuring stability and avoids automatic upgrades even without `package-lock.json`.
Notice that there is no `^` before `11.4.3000`. No `^` indicates an exact version, ensuring stability and avoids automatic upgrades even without `package-lock.json`.

While we keep the SDK's external interface relatively stable, the SDK's internal communication often change with each new version. These changes can potentially lead to compatibility issues with `engineResourcePaths` settings. To prevent any unexpected difficulties and surprises, it's essential to use the exact version of the SDK.

Expand Down
Loading