npm / barcode-detector
barcode-detector
What changed in barcode-detector 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
1 breaking6 new APIs and options1 behavior and defaults2 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initbarcode-detector 310 changes
Breaking changes 1
Detection results now distinguish DataBar and Code 39 sub-variants; code matching exact format values may need to account for the more specific names.
New APIs and options 6
Adds micro_pdf417 as a supported barcode format.
Adds telepen as a supported barcode format.
Adds telepen_alpha as a supported barcode format.
Adds telepen_numeric as a supported barcode format.
The formats option accepts additional format names, including sub-variants and input hints that may filter detection to the appropriate symbology family.
The formats option accepts three shorthand meta formats for selecting GS1-compatible, retail, or industrial barcode formats.
Behavior and default changes 1
Upstream detector improvements may shift some barcodes’ cornerPoints by 1–2 px; rawValue is unchanged.
Fixes and other changes 2
Upstream detector crash fixes are included.
When WASM initialization fails, only a service unavailable DOM exception is thrown instead of unhandled errors.