Barcode Detector API
BarcodeDetector 接口的 detect() 方法返回一个 Promise,它兑现一个从图像中检测到的条形码的Array。
语法
detect(imageBitmapSource)
参数
imageBitmapSource- : 接受一个图像源作为参数;它可以是以下对象之一:HTMLImageElement、SVGImageElement、HTMLVideoElement、HTMLCanvasElement、ImageBitmap、OffscreenCanvas、VideoFrame、Blob 格式的图像或 ImageData。
返回值
返回一个 Promise,它兑现一个具有以下属性的 DetectedBarcode 对象数组:
boundingBox- : 一个 DOMRectReadOnly,返回表示检测到的条形码范围的矩形尺寸,与图像对齐。
cornerPoints- : 检测到的条形码的四个角点相对于图像的 x 和 y 坐标,从左上角开始顺时针旋转。由于图像内的透视变形,这可能不是方形的。
format- : 检测到的条形码格式。(有关格式的完整列表,请参阅受支持的条形码格式类型)
rawValue- : 一个从条形码数据解码的字符串。
异常
- TypeError
- : 如果未指定参数或
type参数不是一个ImageBitmapSource类型,抛出此异常。
- : 如果未指定参数或
SecurityErrorDOMException- : 如果
imageBitmapSource有源并且与文档的源不同,或者如果imageBitmapSource是一个 HTMLCanvasElement 及其 origin-clean 标志设置为false,抛出此异常。
- : 如果
InvalidStateErrorDOMException- : 如果
imageBitmapSource是一个 HTMLImageElement 并且未完全解码或解码失败,或者是一个 HTMLVideoElement 并且其 HTMLMediaElement.readyState 属性是HAVE_NOTHING或HAVE_METADATA,抛出此异常。
- : 如果
示例
此示例使用 detect() 方法来检测给定图像中的条形码。识别结果被迭代并且条形码数据被记录到控制台。
barcodeDetector
.detect(imageEl)
.then((barcodes) => {
barcodes.forEach((barcode) => console.log(barcode.rawValue));
})
.catch((err) => {
console.error(err);
});
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
