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

BarcodeDetector

· 52CE 我爱测

Barcode Detection API 的 **`BarcodeDetector`** 接口允许检测图像中的条形码和二维码。

Barcode Detector API

Barcode Detection API 的 BarcodeDetector 接口允许检测图像中的条形码和二维码。

构造方法

  • BarcodeDetector.BarcodeDetector
    • : 使用可选的 BarcodeDetectorOptions 参数创建并返回一个 BarcodeDetector 对象。

静态方法

  • BarcodeDetector/getSupportedFormats_static

实例方法

  • BarcodeDetector.detect
    • : 返回一个 Promise,它兑现一个具有以下属性的 DetectedBarcode 对象数组:
      • boundingBox: 一个 DOMRectReadOnly,返回表示检测到的条形码范围的矩形尺寸,与图像对齐。
      • cornerPoints:检测到的条形码的四个角点相对于图像的 x 和 y 坐标,从左上角开始顺时针旋转。由于图像内的透视变形,这可能不是方形的。
      • format:检测到的条形码格式。(有关格式的完整列表,请参阅受支持的条形码格式类型)
      • rawValue:一个从条形码数据解码的字符串。

示例

创建检测器

此示例测试浏览器兼容性并使用指定的支持格式创建新的条形码检测器对象。

// 检查兼容性
if (!("BarcodeDetector" in globalThis)) {
  console.log("此浏览器不支持条形码检测器。");
} else {
  console.log("条形码检测器是支持的!");

  // 创建新检测器
  const barcodeDetector = new BarcodeDetector({
    formats: ["code_39", "codabar", "ean_13"],
  });
}

获取支持的格式

以下示例调用 getSupportedFormats() 方法并将结果在控制台打印。

// 检查支持的类型
BarcodeDetector.getSupportedFormats().then((supportedFormats) => {
  supportedFormats.forEach((format) => console.log(format));
});

检测条形码

此示例使用 detect() 方法来检测给定图像中的条形码。识别结果被迭代并且条形码数据在控制台打印。

barcodeDetector
  .detect(imageEl)
  .then((barcodes) => {
    barcodes.forEach((barcode) => console.log(barcode.rawValue));
  })
  .catch((err) => {
    console.log(err);
  });

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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