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

NDEFReader:write() 方法

· 52CE 我爱测

NDEFReader 接口的 `write()` 方法尝试将 NDEF 消息写入标签,并返回一个 Promise,当消息成功写入标签时兑现,或者在遇到硬件或权限错误时拒绝。如果尚未授予“nfc”权限,此方法会触发权限提示。

Web NFC API

NDEFReader 接口的 write() 方法尝试将 NDEF 消息写入标签,并返回一个 Promise,当消息成功写入标签时兑现,或者在遇到硬件或权限错误时拒绝。如果尚未授予“nfc”权限,此方法会触发权限提示。

语法

write(message)
write(message, options)

参数

  • message

    • : 要写入的消息,可以是字符串、ArrayBuffer、TypedArray、DataView,或者是记录数组。具有以下成员:
      • data
        • : 包含要传输的数据;可以是字符串、ArrayBuffer、TypedArray、DataView 或嵌套记录数组之一。
      • encoding
        • : 指定记录编码的字符串。
      • id
        • : 开发人员为记录定义的标识符。
      • lang
        • : 根据 规定的有效语言标签。
      • mediaType
      • recordType
        • : 指示存储在 data 中的数据类型的字符串。必须是以下值之一:
          • "absolute-url"
            • : 指向数据的绝对 URL。
          • "empty"
            • : 一个空的 NDEFRecord。
          • "mime"
          • "smart-poster"
          • "text"
          • "unknown"
            • : 记录类型未知。
          • "URL"
  • options

    • : 一个包含以下属性的对象:
      • overwrite
        • : 一个布尔值,指定是否应覆盖(如果存在的话)现有记录。
      • signal
        • : 一个 AbortSignal,允许取消当前的写入操作。

返回值

一个 Promise,当消息成功写入标签时兑现,或者在遇到硬件或权限错误时拒绝。

异常

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

  • AbortError
    • : 通过在 options 参数中传递的 AbortSignal 中止了扫描操作。
  • NotAllowedError
    • : 此操作的权限已被拒绝,或者 overwrite 设置为 false 而标签上已有记录。
  • NotSupportedError
    • : 没有与 Web NFC 兼容的 NFC 适配器,或者可用的 NFC 适配器不支持推送消息,或者无法建立连接。
  • NotReadableError
    • : 由于用户偏好等原因,用户代理(UA)不允许访问底层 NFC 适配器。
  • NetworkError
    • : 在已经开始传输后发生传输失败(例如,标签已从读卡器移除)。

示例

编写文本字符串

以下示例展示了如何将字符串写入 NFC 标签以及处理发生的任何错误。

const ndef = new NDEFReader();
ndef
  .write("你好,世界")
  .then(() => {
    console.log("所写信息。");
  })
  .catch((error) => {
    console.log(`写入失败 :-( 再试一次:${error}。`);
  });

编写 URL

以下示例展示了如何将上述记录对象写入 NFC 标签以及处理可能发生的任何错误。

const ndef = new NDEFReader();
try {
  await ndef.write({
    records: [{ recordType: "url", data: "http://example.com/" }],
  });
} catch {
  console.log("写入失败 :-( 请再试一次。");
}

设置写入超时

有时为写入操作设置时间限制是有用的。例如,你要求用户触摸标签,但如果在一定时间内未找到标签,则超时。

const ndef = new NDEFReader();
ndef.onreading = (event) => console.log("我们读取了标签!");

function write(data, { timeout } = {}) {
  return new Promise((resolve, reject) => {
    const ctlr = new AbortController();
    ctlr.signal.onabort = () => reject("时间到,退出!");
    setTimeout(() => ctlr.abort(), timeout);

    ndef.addEventListener(
      "reading",
      (event) => {
        ndef.write(data, { signal: ctlr.signal }).then(resolve, reject);
      },
      { once: true },
    );
  });
}

await ndef.scan();
try {
  // 让我们只等待 5 秒钟。
  await write("你好,世界", { timeout: 5_000 });
} catch (err) {
  console.error("出了一些问题", err);
} finally {
  console.log("我们成功写入标签!");
}

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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