术语和约定
使用的扩充巴科斯-诺尔范式（ABNF）表示法在 [[RFC5234]] 中规定。
NFC 表示近场通信，一种在 13.56 MHz 工作的短距离无线技术，使设备在小于 10 cm 的距离内进行通信。NFC 通信协议和数据交换格式基于现有的射频识别（RFID）标准，包括 ISO/IEC
14443 和 FeliCa。
NFC 标准包括 ISO/IEC 18092[5] 以及 NFC Forum 定义的标准。完整列表请参见
NFC Forum 技术规范 。
NFC adapter 是底层平台中的软件实体，提供对在给定硬件组件（NFC 芯片）中实现的 NFC 功能的访问。设备可能有多个 NFC 适配器，例如内置的一个，或者通过 USB
连接的一个或多个。
NFC peer 是一个有源、有电的设备，可以与其他设备交互以使用 NFC 交换数据。
如当前规范所述，点对点（peer-to-peer）不被支持。
NFC device 是 NFC peer 或 NFC tag 。
NDEF 是 NFC Forum 数据交换格式（NFC Forum Data Exchange Format）的缩写，一种在 [[!NFC-NDEF]] 中标准化的轻量二进制消息格式。
NDEF message 封装一个或多个应用定义的 NDEF record 。NDEF 消息可以存储在 NFC tag 上或在启用 NFC 的设备之间交换。
术语 NFC content 表示发送到或从 NFC tag 接收的所有字节。在当前 API 中，它与 NDEF message 同义。
示例
本节展示开发者如何使用本规范的各项功能。
功能支持
检测是否支持 Web NFC 可以通过检查 {{NDEFReader}} 对象来完成。注意，这并不保证 NFC 硬件可用。
if ("NDEFReader" in window) { /* Scan and write NDEF Tags */ }
关于写入数据的一般信息
写入数据通常很直接，但在 NFC 写入工作方式上有一些需要注意的地方。
NFC 读取器通过轮询工作，因此为了能够写入标签或将其永久设为只读，需要先找到并读取标签，这意味着需要首先初始化轮询。
如果尚未通过先调用 `scan()` 启动轮询，则 `write()` 和 `makeReadOnly()` 方法会临时启动轮询，直到找到并读取到标签并尝试执行操作为止。
这意味着流程是先在首次找到标签时执行一次读取，然后再执行写入操作。
这也意味着如果 `scan()` 正在运行且你为 `reading` 事件添加了事件监听器，那么在 `write()` 或 `makeReadOnly()`
操作期间该事件监听器会被触发一次，这可能不是预期的行为。
在接下来的各节中，我们将讨论如何轻松处理此行为，但先给出几个简单示例。
写入文本字符串
向 NFC 标签写入文本字符串很简单。
const ndef = new NDEFReader();
ndef.write(
"Hello World"
).then(() => {
console.log("Message written.");
}).catch(error => {
console.log(`Write failed :-( try again: ${error}.`);
});
写入 URL
为了写入 URL 类型的 NDEF 记录，只需使用 NDEFMessage。下面示例使用 async/await。
const ndef = new NDEFReader();
try {
await ndef.write({
records: [{ recordType: "url", data: "https://w3c.github.io/web-nfc/" }]
});
} catch {
console.log("Write failed :-( try again.");
};
在写入时处理初始读取
为了写入，需要找到并读取标签。这使你能够通过检查现有数据或序列号来判断是否确实是要写入的标签。
因此，建议在 `reading` 事件中调用 `write()`。`makeReadOnly()` 也同理。
下例展示如何在通用的 `reading` 处理器和用于单次写入的处理器之间进行协调。
const ndef = new NDEFReader();
let ignoreRead = false;
ndef.onreading = (event) => {
if (ignoreRead) {
return; // write pending, ignore read.
}
console.log("We read a tag, but not during pending write!");
};
function write(data) {
ignoreRead = true;
return new Promise((resolve, reject) => {
ndef.addEventListener("reading", event => {
// Check if we want to write to this tag, or reject.
ndef.write(data).then(resolve, reject).finally(() => ignoreRead = false);
}, { once: true });
});
}
await ndef.scan();
try {
await write("Hello World");
console.log("We wrote to a tag!")
} catch(err) {
console.error("Something went wrong", err);
}
带超时的写入调度
有时为写入操作设置时间限制会很有用。比如要求用户触碰标签，如果在一定时间内未找到标签，则超时。
const ndef = new NDEFReader();
ndef.onreading = (event) => console.log("We read a tag!");
function write(data, { timeout } = {}) {
return new Promise((resolve, reject) => {
const ctlr = new AbortController();
ctlr.signal.onabort = () => reject("Time is up, bailing out!");
setTimeout(() => ctlr.abort(), timeout);
ndef.addEventListener("reading", event => {
ndef.write(data, { signal: ctlr.signal }).then(resolve, reject);
}, { once: true });
});
}
await ndef.scan();
try {
// Let's wait for 5 seconds only.
await write("Hello World", { timeout: 5_000 });
} catch(err) {
console.error("Something went wrong", err);
} finally {
console.log("We wrote to a tag!");
}
处理扫描错误
本示例展示当 {{NDEFReader/scan}} promise 被拒绝并触发 `readingerror` 时会发生什么。
const ndef = new NDEFReader();
ndef.scan().then(() => {
console.log("Scan started successfully.");
ndef.onreadingerror = (event) => {
console.log("Error! Cannot read data from the NFC tag. Try a different one?");
};
ndef.onreading = (event) => {
console.log("NDEF message read.");
};
}).catch(error => {
console.log(`Error! Scan failed to start: ${error}.`);
});
读取单个标签，仅一次
本示例展示如何轻松创建一个便捷函数，该函数只读取单个标签然后停止轮询，从而通过减少不必要的工作来节省电量。
该示例可以很容易扩展为在给定毫秒后超时。
const ndef = new NDEFReader();
function read() {
return new Promise((resolve, reject) => {
const ctlr = new AbortController();
ctlr.signal.onabort = reject;
ndef.addEventListener("reading", event => {
ctlr.abort();
resolve(event);
}, { once: true });
ndef.scan({ signal: ctlr.signal }).catch(err => reject(err));
});
}
read().then(({ serialNumber }) => {
console.log(serialNumber);
});
从标签读取数据，并向空标签写入
本示例展示如何读取可存储在标签上的各种不同类型的数据。如果标签未格式化或包含空记录，则写入一条值为 "Hello World" 的文本消息。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = async ({ message }) => {
if (message.records.length == 0 || // unformatted tag
message.records[0].recordType == "empty") { // empty record
await ndef.write({
records: [{ recordType: "text", data: "Hello World" }]
});
return;
}
const decoder = new TextDecoder();
for (const record of message.records) {
switch (record.recordType) {
case "text":
const textDecoder = new TextDecoder(record.encoding);
console.log(`Text: ${textDecoder.decode(record.data)} (${record.lang})`);
break;
case "url":
console.log(`URL: ${decoder.decode(record.data)}`);
break;
case "mime":
if (record.mediaType === "application/json") {
console.log(`JSON: ${JSON.parse(decoder.decode(record.data))}`);
}
else if (record.mediaType.startsWith("image/")) {
const blob = new Blob([record.data], { type: record.mediaType });
const img = document.createElement("img");
img.src = URL.createObjectURL(blob);
img.onload = () => window.URL.revokeObjectURL(this.src);
document.body.appendChild(img);
}
else {
console.log(`Media not handled`);
}
break;
default:
console.log(`Record not handled`);
}
}
};
使用 NFC 标签保存并恢复游戏进度
通过使用自定义记录标识符（在本例中为 "`/my-game-progress`"）可以筛选相关数据源。当我们读取数据时，会立即通过使用自定义 NDEF 数据布局写入来更新游戏进度。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = async ({ message }) => {
if (message.records[0]?.id !== "/my-game-progress")
return;
console.log(`Game state: ${ JSON.stringify(message.records) }`);
const encoder = new TextEncoder();
const newMessage = {
records: [{
id: "/my-game-progress",
recordType: "mime",
mediaType: "application/json",
data: encoder.encode(JSON.stringify({
level: 3,
points: 4500,
lives: 3
}))
}]
};
await ndef.write(newMessage);
console.log("Message written");
};
写入与读取 JSON（序列化与反序列化）
使用序列化与反序列化存储和接收 JSON 数据很容易。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = (event) => {
const decoder = new TextDecoder();
for (const record of event.message.records) {
if (record.mediaType === "application/json") {
const json = JSON.parse(decoder.decode(record.data));
const article =/^[aeio]/i.test(json.title) ? "an" : "a";
console.log(`${json.name} is ${article} ${json.title}`);
}
}
};
const encoder = new TextEncoder();
await ndef.write({
records: [
{
recordType: "mime",
mediaType: "application/json",
data: encoder.encode(JSON.stringify({
name: "Benny Jensen",
title: "Banker"
}))
},
{
recordType: "mime",
mediaType: "application/json",
data: encoder.encode(JSON.stringify({
name: "Zoey Braun",
title: "Engineer"
}))
}]
});
写入数据并打印现有数据
写入数据需要触碰 NFC tag 。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = async (event) => {
const decoder = new TextDecoder();
for (const record of event.message.records) {
console.log("Record type: " + record.recordType);
console.log("MIME type: " + record.mediaType);
console.log("=== data ===\n" + decoder.decode(record.data));
}
try {
await ndef.write("Overriding data is fun!");
} catch(error) {
console.log(`Write failed :-( try again: ${error}.`);
}
};
停止监听 NDEF 消息
使用 {{NDEFScanOptions/signal}} 读取 NDEF 消息 3 秒。
const ndef = new NDEFReader();
const ctrl = new AbortController();
await ndef.scan({ signal: ctrl.signal });
ndef.onreading = () => {
console.log("NDEF message read.");
};
ctrl.signal.onabort = () => {
console.log("We're done waiting for NDEF messages.");
};
// Stop listening to NDEF messages after 3s.
setTimeout(() => ctrl.abort(), 3_000);
写入智能海报消息
const ndef = new NDEFReader();
const encoder = new TextEncoder();
await ndef.write({ records: [
{
recordType: "smart-poster", // Sp
data: { records: [
{
recordType: "url", // URL record for the Sp content
data: "https://my.org/content/19911"
},
{
recordType: "text", // title record for the Sp content
data: "Funny dance"
},
{
recordType: ":t", // type record, a local type to Sp
data: encoder.encode("image/gif") // MIME type of the Sp content
},
{
recordType: ":s", // size record, a local type to Sp
data: new Uint32Array([4096]) // byte size of Sp content
},
{
recordType: ":act", // action record, a local type to Sp
// do the action, in this case open in the browser
data: new Uint8Array([0])
},
{
recordType: "mime", // icon record, a MIME type record
mediaType: "image/png",
data: await (await fetch("icon1.png")).arrayBuffer()
},
{
recordType: "mime", // another icon record
mediaType: "image/jpg",
data: await (await fetch("icon2.jpg")).arrayBuffer()
}
]}
}
]});
读取以 NDEF 消息作为有效载荷的外部记录
外部类型记录可以用于创建应用定义的记录。这些记录可以包含一个作为有效载荷的 NDEF message ，
其内部可以有自己的 NDEF records ，包括在应用上下文中使用的 local types 。
注意，smart poster 记录类型也包含一个作为有效载荷的 NDEF message 。
由于 NDEF 不保证记录的顺序，使用包含 NDEF message 作为有效载荷的外部类型记录，对于封装相关数据可能很有用。
本示例展示如何读取用于社交发布的外部记录，该记录包含一个 NDEF message ，其中包含一个文本记录和一个具有 local type "act"（动作）的记录，
其定义借用自 smart poster ，但在本地应用上下文中使用。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = (event) => {
const externalRecord = event.message.records.find(
record => record.type == "example.com:smart-poster"
);
let action, text;
for (const record of externalRecord.toRecords()) {
if (record.recordType == "text") {
const decoder = new TextDecoder(record.encoding);
text = decoder.decode(record.data);
} else if (record.recordType == ":act") {
action = record.data.getUint8(0);
}
}
switch (action) {
case 0: // do the action
console.log(`Post "${text}" to timeline`);
break;
case 1: // save for later
console.log(`Save "${text}" as a draft`);
break;
case 2: // open for editing
console.log(`Show editable post with "${text}"`);
break;
}
};
写入以 NDEF 消息作为有效载荷的外部记录
外部类型记录可以用于创建应用定义的记录，这些记录甚至可以包含一个作为有效载荷的 NDEF message 。
const ndef = new NDEFReader();
await ndef.write({ records: [
{
recordType: "example.game:a",
data: {
records: [
{
recordType: "url",
data: "https://example.game/42"
},
{
recordType: "text",
data: "Game context given here"
},
{
recordType: "mime",
mediaType: "image/png",
data: getImageBytes(fromURL)
}
]
}
}
]});
在外部记录内写入和读取未知记录
未知类型记录在外部类型记录内可能很有用，因为开发者知道它们代表什么，因此可以避免指定 MIME 类型。
const encoder = new TextEncoder();
const ndef = new NDEFReader();
await ndef.write({ records: [
{
recordType: "example.com:shoppingItem", // External record
data: {
records: [
{
recordType: "unknown", // Shopping item name
data: encoder.encode("Food")
},
{
recordType: "unknown", // Shopping item description
data: encoder.encode("Provide nutritional support for an organism.")
}
]
}
}
]});
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = (event) => {
const shoppingItemRecord = event.message.records[0];
if (shoppingItemRecord?.recordType !== "example.com:shoppingItem")
return;
const [nameRecord, descriptionRecord] = shoppingItemRecord.toRecords();
const decoder = new TextDecoder();
console.log("Item name: " + decoder.decode(nameRecord.data));
console.log("Item description: " + decoder.decode(descriptionRecord.data));
};
将 NFC 标签永久设为只读
将 NFC 标签永久设为只读很直接。
const ndef = new NDEFReader();
ndef.makeReadOnly().then(() => {
console.log("NFC tag has been made permanently read-only.");
}).catch(error => {
console.log(`Operation failed: ${error}`);
});
const ndef = new NDEFReader();
try {
await ndef.write("Hello world");
console.log("Message written.");
await ndef.makeReadOnly();
console.log("NFC tag has been made permanently read-only after writing to it.");
} catch (error) {
console.log(`Operation failed: ${error}`);
}
数据表示
接口 NDEFMessage
任意 NDEF message 的内容由 NDEFMessage 接口暴露：
[SecureContext, Exposed=Window]
interface NDEFMessage {
constructor(NDEFMessageInit messageInit);
readonly attribute FrozenArray<NDEFRecord> records;
};
dictionary NDEFMessageInit {
required sequence<NDEFRecordInit> records;
};
records
属性表示定义该 NDEF message 的一列 NDEF record 。
NDEFMessageInit 字典用于初始化一个 NDEF message 。
接口 NDEFRecord
任意 NDEF record 的内容由 NDEFRecord 接口暴露：
[SecureContext, Exposed=Window]
interface NDEFRecord {
constructor(NDEFRecordInit recordInit);
readonly attribute USVString recordType;
readonly attribute USVString? mediaType;
readonly attribute USVString? id;
readonly attribute DataView? data;
readonly attribute USVString? encoding;
readonly attribute USVString? lang;
sequence<NDEFRecord>? toRecords();
};
dictionary NDEFRecordInit {
required USVString recordType;
USVString mediaType;
USVString id;
USVString encoding;
USVString lang;
any data; // DOMString or BufferSource or NDEFMessageInit
};
mediaType 属性表示 NDEF record 有效载荷的 MIME type 。
recordType 属性表示 NDEF record 的类型。
id 属性表示
record identifier ，它是一个绝对或相对的 URL。标识符的唯一性仅由生成者保证，本规范不负责保证。
NFC NDEF 规范使用术语“message identifier”和“payload identifier”而不是 record
identifier ，但该标识符与每个记录相关联而非与消息（记录集合）相关联，并且在没有有效载荷时也可能存在。
encoding 属性表示在有效载荷为文本数据时用于对其进行编码的 [=encoding/name|encoding name=]。
lang 属性表示在有效载荷已编码时的 [=language tag=]。
language tag 是一个匹配 [[BCP47]] 规范中 Language-Tag 产生式的 string （关于可能值的权威列表，请参见
IANA Language Subtag
Registry ）。语言范围由一个或多个由 U+002D HYPHEN-MINUS ("-") 分隔的 subtags
组成。例如，'en-AU' 表示澳大利亚的英语，'fr-CA' 表示加拿大的法语。在不参考 IANA Language Subtag Registry
的情况下，可根据 [[RFC5646]] 第 2.2.9 节验证其结构有效性的语言标签被视为结构上有效。
data 属性表示 PAYLOAD field 的数据。
toRecords() 方法在被调用时，必须返回对给定 NDEF Record 运行 convert NDEFRecord.data bytes 的结果。
NDEFRecordInit 字典用于使用其 record type recordType 、可选的 record identifier
id 和有效载荷数据 data 来初始化一个 NDEF record 。
从 NDEFRecordInit 的数据类型映射到 NDEF record 的规则在处理数据的算法步骤中给出，并在 [[[#steps-receiving]]] 和
[[[#writing-content]]] 节中描述。
要对给定 |record:NDEFRecord| 执行 convert NDEFRecord.data bytes ，请运行以下步骤：
令 |bytes:byte sequence| 为 record 的 data 属性的值。
令 |recordType:record type| 为 |record| 的 recordType 属性的值。
如果 |recordType| 的值为 "`smart-poster`"，则返回对给定 |bytes| 和 `"smart-poster"` 运行 parse records from
bytes 的结果。
如果对 |recordType| 运行 validate external type 返回 true，则返回对给定 |bytes| 和 `"external"` 运行 parse
records from bytes 的结果。
否则，抛出 {{"NotSupportedError"}}。
数据映射
从 NDEFRecordInit 的数据类型到 NDEF record 类型的映射（在 [[[#writing-content]]] 节中使用）如下：
{{recordType}}
{{mediaType}}
{{data}}
record type [=TNF field=]
[=TYPE field=]
"`empty`" 未使用 未使用 Empty record 0
未使用
"`text`" 未使用
{{BufferSource}} 或
[=Well-known type record=]
1
"`T`"
"`url`" 未使用 {{DOMString}}
[=Well-known type record=]
1
"`U`"
"`smart-poster`" 未使用 {{NDEFMessageInit}}
[=Well-known type record=]
1
"`Sp`"
[=local type name=] 前缀为冒号 `U+003A` (`:`)，例如 "`:act`"、"`:s`" 和 "`:t`"
未使用
{{BufferSource}} 或 {{NDEFMessageInit}}
[=Local type=] record*
1
[=local type name=]，例如 "`act`"、"`s`" 和 "`t`"
"`mime`" [= MIME type =]
{{BufferSource}}
MIME type record 2
[= MIME type =]
"`absolute-url`" 未使用 {{DOMString}} url
Absolute-URL record 3
[=Absolute-URL=]
[=external type name=] 未使用
{{BufferSource}} 或
External type record 4
[=external type name=]
"`unknown`" 未使用 {{BufferSource}}
[=Unknown record=]
5
未使用
* 一个 [=local type=] 记录必须嵌入在另一个记录的 NDEFMessage 有效载荷中。
从 NDEF record 类型到 NDEFRecord 的映射（用于描述传入的 NDEF message 的 [[[#steps-receiving]]]
节）如下。
record type [=TNF field=]
[=TYPE field=]
{{recordType}}
{{mediaType}}
[=Empty record=]
0
未使用 "`empty`"
null
[=Well-known type record=]
1
"`T`"
"`text`"
null
[=Well-known type record=]
1
"`U`"
"`url`"
null
[=Well-known type record=]
1
"`Sp`"
"`smart-poster`"
null
[=Local type=] record*
1
[=local type name=]，例如 "`act`"、"`s`" 和 "`t`"
[=local type name=] 前缀为冒号 `U+003A` (`:`)，例如 "`:act`"、"`:s`" 和 "`:t`"
null
[=MIME type record=]
2
[=MIME type=]
"`mime`"
NDEF 记录中使用的 MIME type
[=Absolute-URL record=]
3
URL
"`absolute-url`"
null
[=External type record=]
4
[=external type name=]
[=external type name=]
null
Unknown record 5
未使用 "`unknown`"
null
NDEFReader 对象
NDEFReader 是一个将 NFC 功能暴露给browsing context 的对象：当设备（如标签）位于磁感应场内时读取 NDEF
messages 。此外，它也用于向范围内的 NFC tag 写入 NDEF messages 。
typedef (DOMString or BufferSource or NDEFMessageInit) NDEFMessageSource;
[SecureContext, Exposed=Window]
interface NDEFReader : EventTarget {
constructor();
attribute EventHandler onreading;
attribute EventHandler onreadingerror;
Promise<undefined> scan(optional NDEFScanOptions options={});
Promise<undefined> write(NDEFMessageSource message,
optional NDEFWriteOptions options={});
Promise<undefined> makeReadOnly(optional NDEFMakeReadOnlyOptions options={});
};
[SecureContext, Exposed=Window]
interface NDEFReadingEvent : Event {
constructor(DOMString type, NDEFReadingEventInit readingEventInitDict);
readonly attribute DOMString serialNumber;
[SameObject] readonly attribute NDEFMessage message;
};
dictionary NDEFReadingEventInit : EventInit {
DOMString? serialNumber = "";
required NDEFMessageInit message;
};
NDEFMessageSource 是一个联合类型，表示 {{NDEFReader/write()}} 方法所接受的参数类型。
NDEFReadingEvent 是在有新的 NFC 读取时分派的事件。serialNumber
属性表示用于防冲突和标识的设备序列号；若不可用则为空字符串。message 是一个 NDEFMessage 对象。
NDEFReadingEventInit 用于通过成员 message 以序列号和 NDEFMessageInit 数据来初始化新事件。如果未提供或为
null 的 serialNumber ，则使用空字符串初始化事件。
虽然大多数标签都有稳定的唯一标识符（UID），但并非所有标签都有，有些标签甚至每次读取都会生成一个随机数。序列号通常由 4 或 7 个数字组成，以 `:` 分隔。
一个 {{NDEFReader}} 对象具有以下
内部槽位 ：
Internal Slot
Initial value
Description (non-normative )
[[\WriteOptions]] null
写入所用的 {{NDEFWriteOptions}} 值。
[[\WriteMessage]] null
将要写入的 {{NDEFMessage}}。初始未设置。
onreading 是一个 {{EventHandler}}，用于在有新读取可用时通知。
onreadingerror 是一个 {{EventHandler}}，用于在读取期间发生错误时通知。
与 settings object 关联的 NFC 状态
支持 NFC 的active document 的relevant settings object 关联一个 NFC state 记录，其包含以下内部槽位 ：
Internal Slot
Initial value
Description (non-normative )
[[\Suspended]] false
一个布尔标志，指示 NFC 功能是否suspended ，初始为 false。
[[\ActivatedReaderList]] 空set
一个 {{NDEFReader}} 实例的set 。
[[\PendingWrite]] empty
一个 <|promise:Promise|, |writer:NDEFReader|> 元组，其中 |promise| 保存一个挂起的
{{Promise}}，|writer| 保存一个 {{NDEFReader}}。
[[\PendingMakeReadOnly]] empty
一个 <|promise:Promise|, |writer:NDEFReader|> 元组，其中 |promise| 保存一个挂起的
{{Promise}}，|writer| 保存一个 {{NDEFReader}}。
activated reader objects 是 [[\ActivatedReaderList]] 内部槽位的值。
pending write tuple 是 [[\PendingWrite]] 内部槽位的值。
pending makeReadOnly tuple 是 [[\PendingMakeReadOnly]] 内部槽位的值。
若 [[\Suspended]] 内部槽位为 true，则表示NFC is suspended 。
要 suspend NFC ，将 [[\Suspended]] 内部槽位设为 true。
要 resume NFC ，将 [[\Suspended]] 内部槽位设为 false。
内部槽位仅作为本规范中的记法使用，实现不必将其映射为显式的内部属性。
获取权限
Web NFC API 是一个 [=default powerful feature=]，其 [=powerful feature/name=] 为 "nfc"。
要
obtain permission ，执行以下步骤：
令 |state:PermissionState| 为使用 "nfc" [=getting the current permission state=]
的结果。
如果 |state| 是 {{PermissionState["granted"]}}（即已通过 [[[PERMISSIONS]]] API 将权限授予该origin
和global object ），则返回 true。
否则，如果 |state| 是 {{PermissionState["prompt"]}}，则可选择request permission to use
"nfc" 向用户请求权限。如获授予，则返回 true。
request permission 步骤尚未明确定义。此时 UA 会就给定
origin 和 global object 使用 "nfc" 的策略询问用户；若用户授予权限，则返回 true。
返回 false。
中止挂起的写入操作
要尝试
abort a pending write operation ，执行以下步骤：
如果不存在pending write tuple |tuple|，则中止这些步骤。
如果 |tuple| 的 writer 已经启动了正在进行的 NFC 数据传输，则中止这些步骤。
使用 {{"AbortError"}} 拒绝 |tuple| 的 promise，并中止这些步骤。
拒绝该 promise 将清除 pending write tuple 。
NDEFWriteOptions 字典
dictionary NDEFWriteOptions {
boolean overwrite = true;
AbortSignal? signal;
};
当 overwrite 属性的值为 false 时，write 算法 将读取 NFC tag 以确定其上是否已有
NDEF 记录；若有，则不会执行任何挂起的写入。
signal 属性允许中止 {{NDEFReader/write()}} 操作。
NDEFMakeReadOnlyOptions 字典
dictionary NDEFMakeReadOnlyOptions {
AbortSignal? signal;
};
signal 属性允许中止 {{NDEFReader/makeReadOnly()}} 操作。
NDEFScanOptions 字典
dictionary NDEFScanOptions {
AbortSignal signal;
};
signal 属性允许中止 {{NDEFReader/scan()}} 操作。
Writing content
本节描述如何在定时器到期前，当某个 NFC tag 下次进入近距离范围时，向其写入一个 NDEF message 。任一时刻，对于一个 origin
最多只能设置一个待写入的 NDEF message ，直至当前消息被发送或写入被中止。
write() 方法
要
start the NFC write ，执行以下步骤：
令 |p:Promise| 为 pending write tuple 的 promise。
令 |writer| 为 pending write tuple 的 writer。
令 |options:NDEFWriteOptions| 为 |writer|.[[\WriteOptions]] 。
若近距离范围内的 NFC tag 不支持用于格式化或写入的 NDEF 技术，则以 {{"NotSupportedError"}} 拒绝 |p| 并返回
|p|。
校验NFC 未被暂停 。
若成功，则执行以下步骤：
若 |device| 为 NFC tag 且 |options| 的 overwrite 为 false，则读取该标签以检查是否已有
NDEF 记录。若有，则以 {{"NotAllowedError"}} 拒绝 |p| 并返回 |p|。
令 |output:NDEFMessage| 为 |writer|.[[\WriteMessage]] 。
使用与 |device| 处于通信范围内的 NFC adapter ，以 |output| 作为缓冲区，启动向 |device| 的数据传输。
若近距离范围内的 NFC tag 未格式化且可进行 NDEF 格式化，则先格式化并将 |output| 作为缓冲区写入。
多个适配器应由用户依次使用。几乎不太可能在两个或多个不同且已连接的 NFC adapter
上同时轻触。若确实发生，用户可能需要重复轻触，最好一次一个设备。此处的错误表明需要重试，否则用户可能认为操作在所有连接的 NFC adapter
上都成功了。
若传输失败，以 {{"NetworkError"}} 拒绝 |p| 并中止这些步骤。
当传输完成时，resolve |p|。
Making content read-only
本节描述当某个 NFC tag 在近距离范围内时，如何将其永久设为只读。任一时刻，对于一个 origin 最多只能有一个请求，直到该 NFC tag
被永久设为只读或操作被中止。
makeReadOnly() 方法
要
start the NFC make read-only ，执行以下步骤：
令 |p:Promise| 为 pending makeReadOnly tuple 的 promise。
若近距离范围内的 NFC tag 不支持用于格式化的 NDEF 技术，则以 {{"NotSupportedError"}} 拒绝 |p| 并返回 |p|。
校验NFC 未被暂停 。
若成功，则执行以下步骤：
使用与 |device| 处于通信范围内的 NFC adapter ，将 |device| 永久设为只读。
若操作失败，以 {{"NetworkError"}} 拒绝 |p| 并中止这些步骤。
当操作完成时，resolve |p|。
此操作不可逆。一旦某个 NFC 标签被设为只读，就无法再写入。
解析内容
从字节解析记录
给定 |bytes:byte sequence| 和 |context: string|，要parse records from bytes ，执行以下步骤：
若 |bytes| 的长度为 `0`，返回 null。
令 |records| 为空列表。
当 |bytes| 仍有未读字节时，运行以下子步骤：
若 |bytes| 的剩余长度小于 `3`，返回 null。
若以下任一步骤需要读取超出 |bytes| 剩余长度的字节，返回 null。
令 |ndef| 为当前 NDEF record 的表示。
令 |header:byte| 为 |bytes| 的下一个字节。
令 |messageBegin:boolean|（MB field ）为 |header| 的最高位（位 7）。
若这是这些子步骤的首次迭代且 |messageBegin| 为 false，返回 null。
令 |messageEnd:boolean|（ME field ）为 |header| 的位 6。
由于分片记录不允许作为子记录，忽略位 5（CF field ）。
令 |shortRecord:boolean|（SR field ）为 |header| 的位 4。
令 |hasIdLength:boolean|（IL field ）为 |header| 的位 3。
令 |ndef| 的 |typeNameField:number|（TNF field ）为 |header| 的位 2-0 的整数值。
令 |typeLength:number| 为 |bytes| 下一个字节（TYPE LENGTH field ）的整数值。
若 |shortRecord| 为 true，令 |payloadLength:number| 为 |bytes| 下一个字节（PAYLOAD LENGTH
field ）的整数值。
否则，令 |payloadLength| 为 |bytes| 下一个 4 个字节的整数值。
若 |hasIdLength| 为 true，令 |idLength:number| 为 |bytes| 下一个字节（ID LENGTH
field ）的整数值；否则令其为 `0`。
若 |typeLength| > 0，令 |ndef| 的 |type:string| 为对接下来的 |typeLength|（TYPE field ）字节运行
UTF-8 decode 的结果；否则令 |type| 为空字符串。
若 |idLength| > 0，令 |ndef| 的 |id:string| 为对接下来的 |idLength|（ID field ）字节运行 UTF-8
decode 的结果；否则令 |ndef| 的 |id| 为空字符串。
令 |ndef| 的 |payload| 为最后 |payloadLength|（PAYLOAD field ）字节的 byte
sequence ，该值可以为 `0` 字节。
令 |record:NDEFRecord| 为对 |ndef| 和 |context| 运行 parse an NDEF record 的结果。
若 |record| 非 null，将其 append 到 |records|。
若 |messageEnd| 为 true，
若对 |records| 和 |context| 运行 check parsed records 抛出 |error|，则以 |error| 拒绝
|promise| 并中止这些步骤。
否则中止这些子步骤（终止循环）。
返回 |records|。
检查已解析记录
给定 |records: NDEFRecord sequence| 和 |context: string|，要check parsed records ，执行以下步骤：
若 |context| 为 `"smart-poster"` 且 |records| 不包含且仅包含一个 URI record ，或其包含多于一个的 type
record 、size record 或 action record ，则[= exception/throw =] 一个
{{TypeError}}。
否则返回 true。
解析 NDEF well-known `T` 记录
给定 |ndefRecord|，要
parse an NDEF text record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`text`"。
将 |record| 的 mediaType 设为 null。
若 |ndefRecord| 的 PAYLOAD field 不存在，将 |record| 的 data 设为 null 并返回 |record|。
令 |header:byte| 为 |ndefRecord| 的 PAYLOAD field 的第一个 byte 。
令 |languageLength:octet| 为 |header| 的位 `5` 至位 `0` 的值。
令 |language:string| 为对第二个 byte 至第 |languageLength| + `1` 个字节（含）运行 ASCII decode
的结果。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 其余部分（不含 |header| 与
|languageLength| 数量的字节）的 byte sequence 。
将 |record| 的 lang 设为 |language|。
若 |header| 的位 `7` 为 `0`，将 |record| 的 encoding 设为 "`utf-8`"，否则设为 "`utf-16be`"。
将 |record| 的 data 设为 |buffer|。
返回 |record|。
Unicode 标准定义了多种编码，如 UTF-8、UTF-16 和 UTF-32。UTF-8 是 Web 上的首选编码，它的优点是与端序无关，因为 [=code points=]
以单个字节表示。
NDEF 文本记录允许文本以 UTF-8 或 UTF-16 编码。一般而言，Web 上更推荐使用 UTF-8，但与现有系统集成时可能需要 UTF-16。
数据传输顺序以及 NDEF 的字节顺序在 [[[NFC-NDEF]]] 中定义为大端（BE），这意味着所有内容都以大端字节序读回。
对于 UTF-16，字节序很重要，因为每个 [=code point=] 占用两个字节，在读写之间可能不同。因此，UTF-16 编码的文本通常包含一个字节序标记（BOM），写作
`0xFEFF`。这意味着如果主机与 NDEF 的字节序不同，则将读回为 `0xFFFE`，表明应交换字节序。[[[ENCODING]]] 根据字节序区分 UTF-16 为
UTF-16BE（大端）和 UTF-16LE（小端）。
若不存在字节序标记，则应假定为 UTF-16BE 编码。
使用decoder 且 `encoding` 设为 `utf-16`
时，若存在字节序标记将自动检测是否需要交换字节。在没有字节序标记时可使用 `utf-16be` 按大端读取。
使用encoder 只能编码为 UTF-8，因此若需要 UTF-16，必须手动或使用库进行编码。
解析 NDEF well-known `U` 记录
给定 |ndefRecord|，要
parse an NDEF URL record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`url`"。
将 |record| 的 mediaType 设为 null。
若 |ndefRecord| 的 PAYLOAD field 不存在，将 |record| 的 data 设为 null 并返回 |record|。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte sequence 。
令 |prefixByte:byte| 为 |buffer| 的第一个 byte 的值。
若 |prefixByte| 的值匹配 [[[NFC-STANDARDS]]] URI Record Type Definition 第 3.2.2 节 表 3 中的 URL
扩展代码，
令 |prefixString:string| 为与 |prefixByte| 值对应的 byte sequence 值。
将 |record| 的 data 设为 |prefixString| 与 |buffer| 连接后的结果。
否则，若 |prefixByte| 无匹配，则将 |record| 的 data 设为 |buffer|。
返回 |record|。
解析 NDEF well-known `Sp` 记录
给定 |ndefRecord|，要
parse a smart-poster size record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`:s`"。
将 |record| 的 mediaType 设为 null。
若 |ndefRecord| 的 PAYLOAD field 不为恰好 4 字节，[= exception/throw =] 一个 {{TypeError}}。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte sequence 。
将 |record| 的 data 设为 |buffer|。
应用可以将该值解析为一个 32 位无符号整数，表示 smart-poster 中 URI 记录所引用对象的大小。
返回 |record|。
给定 |ndefRecord|，要
parse a smart-poster type record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`:t`"。
将 |record| 的 mediaType 设为 null。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte sequence 。
应用可以将该值解析为一个字符串，包含 [[RFC2048]] 媒体类型，表示 smart-poster 中 URI 记录所引用对象的媒体类型。
将 |record| 的 data 设为 |buffer|。
返回 |record|。
给定 |ndefRecord|，要
parse a smart-poster action record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`:act`"。
将 |record| 的 mediaType 设为 null。
若 |ndefRecord| 的 PAYLOAD field 不为恰好 1 字节，[= exception/throw =] 一个 {{TypeError}}。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte sequence 。
将 |record| 的 data 设为 |buffer|。
应用可以将该值解析为一个 8 位无符号整数，其取值定义见此处 。
返回 |record|。
解析 local type 记录
给定 |ndef|，要
parse a local type record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`:`"（`U+003A`）与 |ndef| 的 |type:string| 连接后的结果。
将 |record| 的 mediaType 设为 null。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte sequence 。
将 |record| 的 data 设为 |buffer|。
返回 |record|。
解析 NDEF absolute-URL 记录
给定 |ndefRecord|，要
parse an NDEF absolute-URL record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`absolute-url`"。
将 |record| 的 mediaType 设为 null。
令 |buffer:byte sequence| 为 |ndefRecords| 的 TYPE field 的 byte sequence 。
将 |record| 的 data 设为 |buffer|。
返回 |record|。
解析 NDEF external type 记录
给定 |ndefRecord|，要
parse an NDEF external type record 将其解析为 |record:NDEFRecord|，执行以下步骤：
若对记录的 |ndefRecord| 的 TYPE field 运行 [=validate external type=] 返回 false，返回 null。
令 |domain| 和 |type| 为以 |ndefRecord| 的 TYPE field 的值运行 [=split external type=] 的结果。
令 |domain| 为运行 Unicode
ToUnicode 的结果，参数为
|domain_name|=|domain|、|CheckHyphens|=false、|CheckBidi|=true、|CheckJoiners|=true、|UseSTD3ASCIIRules|=true、|Transitional_Processing|=false。若结果包含任何错误，返回
null。
TYPE field 包含以 ASCII 存储的域名部分，例如 "xn--hndvrker-9zan.dk:abc" 经过上述转换后会呈现为
"håndværker.dk:abc"。
将 |record| 的 recordType 设为 |domain|、"`:`" 与 |type| 连接后的结果。
将 |record| 的 mediaType 设为 null。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte
sequence （若存在），否则为 null。
将 |record| 的 data 设为 |buffer|。
返回 |record|。
解析 NDEF unknown type 记录
给定 |ndefRecord|，要
parse an NDEF unknown record 将其解析为 |record:NDEFRecord|，执行以下步骤：
将 |record| 的 recordType 设为 "`unknown`"。
将 |record| 的 mediaType 设为 null。
令 |buffer:byte sequence| 为 |ndefRecords| 的 PAYLOAD field 的 byte
sequence （若存在），否则为 null。
将 |record| 的 data 设为 |buffer|。
返回 |record|。
安全与隐私
信任链
实现需要确保当用户授权 Web NFC API 的某个方法时，只执行该操作且无任何副作用。
默认情况下，NDEF 并不提供使内容被信任的机制，除了允许在写入数据后将标签永久设为只读。这甚至可以在工厂设置中完成。
通过此 API 写入的数据不会自动签名或加密，这与现有原生 NFC API 一致。为保护 NDEF 消息的完整性与真实性，NFC 论坛引入了 [[NDEF-SIGNATURE]]。使用 NDEF
signature 和密钥管理由应用自行负责。
若要信任通过 NFC 交换的数据的机密性 ，应用可以使用加密的 NFC content 。
若要信任通过 NFC 交换的数据的完整性 ，应用可以使用 NDEF signature ，并基于公钥基础设施（PKI）进行密钥管理。
关于 MIME 类型的一般安全注意事项见 [[RFC2048]] 和 [[RFC2046]]。
隐私影响与实现考量
与条形码或二维码的比较是恰当的，因为 NFC 标签是另一种非人可读的数据交换方式，共享它们可能带来意想不到的隐私与安全影响。网站读取二维码时，必须使用打断式
UI（相机）来拍摄图像，使用户清楚该图像（包括二维码）的内容将可供网页使用，从而明确告知用户正在进行扫描。
使用 NFC 扫描标签需要用户将扫描设备（如手机）置于 NFC 标签的近距离范围内——通常为 5-10 厘米（2-4 英寸）。
当未激活 Web NFC 扫描时扫描标签，会触发主机操作系统处理。因此，从 NFC 标签扫描并启动 URL 或应用并非由 Web NFC 自身处理或支持。
此外，Web NFC 的扫描需要由用户交互触发，且当网站不在焦点或设备屏幕熄灭（即设备未解锁）时，扫描会被暂停。这样设计是为了降低偶发扫描的可能性。
Web NFC 还建议实现从用户体验角度（UX）清晰告知：当把扫描设备靠近 NFC 标签时会进行数据扫描——基本上模仿扫描二维码的 UX 流程。
可采用多种方式实现，例如播放提示音，或在扫描可能发生时显示持续的 UI，比如带有随时可取消能力的模态对话框。
实现还可以显示即将上传的数据，推迟数据分享直到用户确认，甚至显示允许用户选择要分享的记录的 UI。
扫描期间的读写
当用户扫描标签时，网页应用可读取标签上的数据；若其不是只读，也可以向标签写入数据。面向私人使用的消费者贴纸（例如创客社区）通常是未上锁的（可读+可写），而商业部署的 NFC 通常是只读的。
旧协议 SNEP（Simple NDEF Exchange Protocol）允许有源设备（如手机）从另一有源设备接收 NDEF 数据，但 Web NFC 不支持它，且在受支持的原生平台上也在被弃用。
新协议 TNEP（Tag NDEF Exchange Protocol）允许扫描设备（如手机）与主动供电的设备（如 IoT 设备）进行双向通信。Web NFC
目前不支持它，且该协议对可接受的输入有限制，IoT 设备必须确保所接受的记录有效。
如果标签包含隐私敏感数据，则该数据会被分享给站点。如果 UX 要求用户在执行前确认数据交换，则可能不会立即分享。
某些情况下，标签/设备包含隐私敏感数据是显而易见的，例如配备 NFC 的会议胸牌和名片。又如配备 NFC 的血糖仪，可能表明你或近亲为糖尿病患者。
其他情况下，这一点可能不明显，但用户可能曾使用应用或网站向标签写入数据，而该数据在用户不知情的情况下编码了用户 ID 等信息，之后任何其他站点都可能读取到。
私密和意外的数据也可能存储在文件中（例如文字处理文档、PDF 或相机图像），并通过文件上传 API 上传。与文件上传相比，Web NFC API 所采用的缓解措施更强，且数据更不可能与个人直接关联。
扫描期间的读写
对标签的扫描还可能暴露用户位置——若网站能够识别标签并知道该标签在现实世界中的位置（例如安装在博物馆内部）。也可能通过某些线索推断位置，例如 FeliCa NFC 标签多用于日本，但 Web NFC
并不会透露所用的标签技术。
这并不会把网络广告与跟踪模型带入现实世界，因为这需要用户的操作，且不能在后台触发；通过良好的 UX 应清楚地表明扫描处于激活状态。
覆盖现有数据
还存在担忧：向 NFC 标签写入可能损坏或“变砖”。由于 NFC 标签被设计为可由多个用户应用读取，NDEF 标签提供了便捷方式可将设备永久设为只读，甚至可在工厂中配置为只读。
NDEF 是用于读写数据的简单交换格式，而非双向通信。NFC 支持多种基于更低层技术的通信格式（因此不像 NDEF 那样被锁定为只读），且这些格式均不受 Web NFC 支持。
使用 NFC 时应告知用户的事项
本节列出用户在使用 NFC 时应当了解的一些事项。建议实现方在执行相关 NFC 操作之前或期间，帮助用户了解这些事实。
读取的数据会与站点共享
当站点有权读取 NFC 内容时，被扫描标签的数据将与该站点共享，类似上传文件和图片。与任何站点一样，是否信任站点以适当、预期的方式处理这些数据取决于用户。
站点可能修改并覆盖未设为只读的标签数据
已部署的 NFC 方案（例如商店中的标签）应始终设为只读，以确保不会因错误或恶意行为而被修改。
私人标签和贴纸往往出厂即未上锁（可写），用户应意识到此类标签在被扫描时可能被覆盖/修改。
读取固定（例如已安装）标签可能暴露读取位置
固定标签可能在数据中编码其 ID 或位置，这意味着读取该标签会将此信息暴露给知道该标签物理位置的站点，从而推断读取发生的位置。这与登录某项服务相结合，可能将你的位置信息分享给该站点。
写入的数据可被其他具有读取权限的应用和站点读取。任何标签上的 NDEF 数据都可被具有相应访问权限的任何应用或网站读取，因此若不希望如此，数据应以安全方式加密，使仅有被授权者能够读取。
读取场内可能同时存在多个标签
NFC 一次只能读取一个标签，但可以检测到多个标签，并可在其中选择一个进行通信。
这类用例包括：钱包中有多张智能卡（基于 NFC），但不想把卡取出。
这主要适用于由外部硬件读取的支付卡和交通卡，因此不是 Web NFC 的用例。对于 Web NFC，当存在多个可用标签时我们不允许读取，以防以下攻击向量。
存在一种攻击向量：有人将另一个恶意 NFC 标签/贴纸覆盖在合法标签上，以加载错误的应用/站点，或向正确的应用/站点注入错误数据。他们可以通过克隆原标签数据并加以修改来实现——要么将 URL
改为加载恶意应用/站点，要么更改数据以向正确的应用/站点注入恶意数据。示例：标签本应带你访问 https://example.com 却被修改为
https://exаmple.com（其中包含西里尔字母 а）——看起来很像真的，你可能会向恶意站点提供敏感数据。
从标签加载网站不在 Web NFC 的范围内，但建议用户代理在存在多个标签时不要自动加载 URL，以避免上述攻击向量。
通过在存在多个标签时禁止读取，Web NFC 能较好地防止向站点注入错误/恶意数据，因为屏蔽现有 NFC 标签相当困难，需要铁氧体屏蔽且较为明显。金属会干扰磁场，使标签不可读。
安全策略
本节列出实现的规范性安全策略。
阻止列表
Web NFC 包含一个 blocklist ，用于阻止存在漏洞的 NFC 设备被网站利用。
限制自动处理
当 NFC content 的载荷数据不受信任时，UA 不得（MUST NOT）使用其自动处理内容，例如自动打开 NFC tag 中发现的 URL
所指向的网页、安装应用或执行其他操作，除非用户批准。
