大网数据广告活动
Web 标准与前端开发

BarcodeDetector:detect() 方法

· 52CE 我爱测

BarcodeDetector 接口的 **`detect()`** 方法返回一个 Promise,它兑现一个从图像中检测到的条形码的Array。

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 类型,抛出此异常。
  • SecurityError DOMException
    • : 如果 imageBitmapSource 有源并且与文档的源不同,或者如果 imageBitmapSource 是一个 HTMLCanvasElement 及其 origin-clean 标志设置为 false,抛出此异常。
  • InvalidStateError DOMException
    • : 如果 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。