浏览器里识别二维码:BarcodeDetector + 纯 JS 兜底,以及为什么解码结果绝不自动跳转

1 阅读3分钟

声明:我是 ToolKnit 的开发者,文末提到的工具是我做的。本文由 AI 辅助起草,代码和结论已人工核对。

电脑屏幕上看到一个二维码(邮件附件、PDF 账单、网页截图),很多人的第一反应是掏出手机扫。问题是手机相机经常在你看清域名之前就打开了链接,二维码钓鱼(Quishing)正是利用这一点。我做“二维码本地解码”时主要考虑了两件事:桌面浏览器能不能稳定识别,以及识别出来的内容怎样安全地展示。

1. 优先使用 BarcodeDetector,不支持时再兜底

部分浏览器和系统提供了原生的 BarcodeDetector,能用就优先用:

async function detectQR(bitmap) {
  if ("BarcodeDetector" in window) {
    const formats = await BarcodeDetector.getSupportedFormats();
    if (formats.includes("qr_code")) {
      const det = new BarcodeDetector({ formats: ["qr_code"] });
      const codes = await det.detect(bitmap);
      if (codes.length) return codes[0].rawValue;
    }
  }
  return fallbackDecode(bitmap); // 纯 JS 解码器
}

注意:不能只判断 "BarcodeDetector" in window,还要检查 getSupportedFormats() 里有没有 qr_code。在不少桌面环境里这个对象存在,但并不支持二维码。

兜底方案是内置一个纯前端的 ISO 18004 解码器(定位图形 → 网格采样 → 里德-所罗门纠错)。这样即使接口不可用或者断网,标准二维码也能识别。

2. 支持 Ctrl+V 粘贴截图

桌面上最顺手的流程是“截图 → 粘贴”:

document.addEventListener("paste", async (e) => {
  const item = [...e.clipboardData.items].find(i => i.type.startsWith("image/"));
  if (!item) return;
  const bitmap = await createImageBitmap(item.getAsFile());
  show(await detectQR(bitmap));
});

Windows 用 Win+Shift+S,Mac 用 Cmd+Ctrl+Shift+4 截到剪贴板,回到页面按 Ctrl+V 就能识别。

3. 结果只当纯文本,绝不自动跳转

这一部分最重要:

  • 用 textContent 渲染结果,不用 innerHTML,也不生成可以点击的 <a>
  • 不预加载链接、不用 iframe 打开,避免触发追踪像素或重定向
  • 对这些情况给出醒目提示:Punycode 域名(xn-- 开头)、纯 IP 主机、http:// 明文链接、javascript: 之类的脚本协议
function riskFlags(text) {
  const flags = [];
  try {
    const u = new URL(text);
    if (u.hostname.startsWith("xn--") || u.hostname.includes(".xn--")) flags.push("Punycode 域名");
    if (/^\d{1,3}(\.\d{1,3}){3}$/.test(u.hostname)) flags.push("纯 IP 主机");
    if (u.protocol === "http:") flags.push("HTTP 明文");
    if (!["http:", "https:"].includes(u.protocol)) flags.push("非网页协议:" + u.protocol);
  } catch { /* 非 URL,按普通文本展示 */ }
  return flags;
}

4. 识别失败时怎么办

  • 4K 全屏截图里二维码只占一个角落时,单独框选二维码再截一次,四周留一圈白边,让每个模块至少有 3~4 像素
  • 三个“回”字定位框不能被遮挡;反光、透视变形严重或中心 Logo 太大,都可能超出纠错能力
  • 把方块换成圆点、去掉静区的艺术二维码,本来就不太适合标准解码

现成工具

上面的思路做成了 在线二维码识别与图片解码器:支持 PNG/JPG/WebP 图片或直接 Ctrl+V 粘贴截图,图片在浏览器本地解码不上传,结果只以纯文本显示。2FA 备份码、Wi-Fi 二维码这类敏感截图也不会离开你的设备。其他本地小工具可以在 ToolKnit 首页 找到。