NDEFReader

Интерфейс NDEFReader API Web NFC используется для чтения и записи данных на совместимые NFC-устройства, например, NFC-метки, поддерживающие NDEF, когда эти устройства находятся в магнитном индукционном поле считывателя.

NDEFReader() Экспериментальная

Возвращает новый объект NDEFReader.

Интерфейс NDEFReader наследует методы EventTarget, своего родительского интерфейса.

NDEFReader.scan() Экспериментальная

Активирует устройство считывания и возвращает Promise, который разрешается, когда операция чтения NFC-метки запланирована, или отклоняется, если возникает ошибка аппаратного обеспечения или ошибка разрешения. Этот метод вызывает запрос на разрешение, если разрешение «nfc» ранее не было предоставлено.

NDEFReader.write() Экспериментальная

Попытка записать сообщение NDEF в метку и возвращает Promise, который разрешается, когда сообщение было записано в метку, или отклоняется, если возникает ошибка аппаратного обеспечения или ошибка разрешения. Этот метод вызывает запрос на разрешение, если разрешение «nfc» ранее не было предоставлено.

Наследует события от своего родителя, EventTarget.

reading Экспериментальная

Срабатывает, когда доступно новое чтение со совместимых NFC-устройств.

readingerror Экспериментальная

Срабатывает, когда метка находится вблизи устройства чтения, но не может быть прочитана.

Пример ниже демонстрирует, как согласовать общую обработку чтения и обработку, используемую специально для одной записи. Для записи метка должна быть найдена и прочитана. Это позволяет проверить, является ли это действительно метка, в которую вы хотите записать. Поэтому рекомендуется вызывать write() из события чтения.

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);
}