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

NDEFReader:scan() 方法

· 52CE 我爱测

NDEFReader 接口的 `scan()` 方法激活读取设备并返回一个 Promise,其会在添加执行 NFC 标签读取操作的计划后兑现,或者在遇到硬件或权限错误时拒绝。如果尚未授予“nfc”权限,则此方法会触发权限提示。

Web NFC API

NDEFReader 接口的 scan() 方法激活读取设备并返回一个 Promise,其会在添加执行 NFC 标签读取操作的计划后兑现,或者在遇到硬件或权限错误时拒绝。如果尚未授予“nfc”权限,则此方法会触发权限提示。

语法

scan(options)

参数

  • options
    • : 一个包含以下属性的对象:
      • signal
        • : 一个 AbortSignal,允许取消此 scan() 操作。

返回值

一个 Promise,在为 NFC 适配器安排读取操作后立即兑现。

异常

此方法不抛出异常;相反,它会拒绝返回的 promise,并传入一个 DOMException,其 name 属性是以下值之一:

  • AbortError DOMException
    • : 如果使用 options 参数中传递的 AbortSignal 中止了扫描操作,则返回此异常。
  • InvalidStateError DOMException
    • : 如果有正在进行中的扫描,则返回此异常。
  • NotAllowedError DOMException
    • : 如果拒绝了对此操作的权限,则返回此异常。
  • NotSupportedError DOMException
    • : 如果不存在与 Web NFC 兼容的 NFC 适配器或无法建立连接,则返回此异常。

示例

处理扫描错误

此示例展示了当扫描 promise 被拒绝且抛出 readingerror 时会发生什么。

const ndef = new NDEFReader();
ndef
  .scan()
  .then(() => {
    console.log("扫描启动成功。");
    ndef.onreadingerror = (event) => {
      console.log("错误!无法从 NFC 标签读取数据。尝试换一个?");
    };
    ndef.onreading = (event) => {
      console.log("已读取 NDEF 消息。");
    };
  })
  .catch((error) => {
    console.log(`错误!扫描启动失败:${error}。`);
  });

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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