51工具盒子

依楼听风雨
笑看云卷云舒,淡观潮起潮落

前端原生API实现条形码二维码的JS解析识别


qrcode封面图

今天才知道,浏览器纯JS不仅可以生成条形码和二维码,还原生支持对条形码和二维码的解析。

一、BarcodeDetector API

浏览器解析二维码、条形码使用的是Barcode Detection API。

其使用套路都是围绕下面这三个展开。

1. 声明检测器

使用 BarcodeDetector 构造一个检测器。

if ('BarcodeDetector' in window) {
  // 创建检测器
  const barcodeDetector = new BarcodeDetector({
    // formats 是检测的条码格式类型
    formats: ['qr_code']
  });
}

其中,使用 formats 参数声明检测的条码类型。

支持各种类型的条形码和二维码,具体见下表:

| 格式 | 描述 | 图示 | |-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------| | aztec | 遵循iso24778规则的二维方型矩阵,形似Aztec金字塔,不需要外面有空白区域。 | Aztec barcode,由小的方型黑白块组成 | | code_128 | 线性(一维)、双向可解码、自检,条形码遵循iso15417规范,能够编码所有128个ASCII字符(故因此命名)。 | code-128编码示意 | | code_39 | 遵循iso16388规范的线性(一维)自检条形码。它是离散的可变长度条形码类型。 | code-39编码示意 | | code_93 | 一种采用bc5规范,线性的、连续符号,长度可变的编码。和code_128视觉上相似,提供的信息密度比的code_39更大。code_93主要用在加拿大邮政,用来编码快递信息。 | code 93格式编码示意 | | codabar | 一种用来表示字符0-9, A-D 以及符号 -- . $ / +的线性条形码 | codabar格式条形码 | | data_matrix | 遵循iso16022规范的不区分发现的二维条码,使用黑白模块组成。 | data matrix barcode | | ean_13 | 基于UPC-A标准并在iso15420中定义的线性条形码。 | EAN-13编码图示意 | | ean_8 | iso15420中定义的线性条形码,源自EAN-13。 | EAN-8格式的编码 | | itf | 一种连续、自检、双向可解码的条形码。它将始终编码14位数字。 | ITF Barcode | | pdf417 | 具有多行和多列的连续二维条形码符号格式。它是双向可解码的,使用iso15438标准。 | pdf417编码格式示意 | | qr_code | 使用iso18004标准的二维条形码。编码的信息可以是文本、URL或其他数据。 | QR code案例示意 | | upc_a | 最常见的线性条码类型之一,广泛应用于美国的零售业。在iso15420中定义,它通过条形和空格表示数字,每个数字都与2个条形和2个空格的唯一模式相关联,这两个条形和空格的宽度都是可变的。UPC-A可以编码唯一分配给每个交易项目的12位数字,从技术上讲,它是EAN-13的子集(UPC-A代码以EAN-13表示,第一个字符设置为0)。 | upc-a barcode图示 | | upc_e | iso15420规范中定义的UPC-A的变体,压缩了不必要的零,以获得更紧凑的条形码。 | upc-e编码图形示意 | | unknown | 表示平台不识别此值或被检测或支持的指定的条形码格式。 | |

2. 支持解析的条码类型

以下代码可以识别支持检测的条码类型:

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

例如,在我的Mac Chrome浏览器下运行的结果是:

支持的解析类型

共支持十一种条码的解析,其中就包括在Web领域非常常用的二维码解析 -- qr_code。

3. 条码的解析

如果想要解析某条码图片,则可以使用类似下面的JavaScript代码:

barcodeDetector.detect(eleImg).then((barcodes) => {
    barcodes.forEach((barcode) => {
        console.log('解析结果是:' + barcode.rawValue);
    });
}).catch((err) => {
    console.error(`解析出错:${err}`);
});

其中,eleImg 不仅可以是 <img> 元素,SVGImageElement、HTMLVideoElement、HTMLCanvasElement、ImageBitmap、OffscreenCanvas、VideoFrame、Blob图形或ImageData数据都是可以的。

也就是任意的Web中的图像类型都可以作为条形码解析的图形参数。

下面看下真实的演示结果。

二、案例演示与支持情况

您可以狠狠地点击这里:纯JS解析二维码图片demo

大家可以上传,或者粘贴任意的二维码图像进行测试。

或者,你可以世界使用demo页面提供的二维码素材,如下图所示:

复制内置二维码图片示意

此时,再点击"识别"按钮,就可以知道此二维码对应的信息了。

识别结果示意

如果你的Chrome不支持?

如果您发现你当前浏览器显示的是不支持 BarcodeDetector,看看你的操作系统是不是Windows系统,目前,此特性仅在 OS X系统下的Chrome浏览器以及Android操作系统的Chrome下支持,截图示意:

BarcodeDetector兼容性示意

至于Safari浏览器什么时候支持这一特性,我估计,至少还有一两年时间。

所以,目前要想在生产环境对二维码进行解析,还是需要借助第三方的JS工具,比方说这个Github项目:https://github.com/cozmo/jsQR

可以纯JS代码解析二维码,使用示意:

const code = jsQR(imageData, width, height, options?);
if (code) {
console.log("找到QR code了", code);
}

三、条形码二维码的生成

这里,再介绍下如何纯前端生成条形码,或者二维码。

如果你是希望下载无水印的干净的二维码(例如希望弄一个上面demo页面解析所需的的二维码图片),也可以试试我自己做的个小工具页面 -- "在线转二维码小工具":https://www.zhangxinxu.com/sp/qrcode.html

二维码生成小工具

好,以上就是本文全部内容,主要介绍了下全新的BarcodeDetector这个原生条码解析API,展示了几个与条形码二维码编码解码相关的Github开源项目。

希望能够对大家的学习有所帮助。

也欢迎大家转发,分享与点赞(如果有)。

???

(本篇完)

赞(1)
未经允许不得转载:工具盒子 » 前端原生API实现条形码二维码的JS解析识别