NDEFReader: метод scan()

Метод scan() интерфейса NDEFReader активирует устройство чтения и возвращает Promise, который разрешается, когда операция чтения NFC-метки запланирована, или отклоняется, если возникает ошибка аппаратного обеспечения или разрешений. Этот метод вызывает запрос на разрешение, если разрешение "nfc" ранее не было предоставлено.

options Необязательный

Объект со следующими свойствами:

signal

AbortSignal, позволяющий отменить эту операцию scan().

A Promise, который разрешается сразу после планирования операций чтения для NFC-адаптера.

Этот метод не генерирует исключения; вместо этого он отклоняет возвращённый промис, передавая DOMException, у которого name является одним из следующих:

AbortError DOMException

Возвращается, если операция сканирования была прервана с помощью AbortSignal, переданного в аргументе options.

InvalidStateError DOMException

Возвращается, если уже происходит сканирование.

NotAllowedError DOMException

Возвращается, если разрешение на эту операцию было отклонено.

NotSupportedError DOMException

Возвращается, если нет NFC-адаптера, совместимого с Web NFC, или соединение не может быть установлено.

В этом примере показано, что происходит, когда промис сканирования отклоняется и возникает 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}.`);
  });