Back to Content

NDEFReadingEvent: message property

files/en-us/web/api/ndefreadingevent/message/index.md

latest1.1 KB
Original Source

{{APIRef("Web NFC API")}}{{securecontext_header}}{{SeeCompatTable}}

The message property of the {{domxref("NDEFReadingEvent")}} interface returns an {{DOMxRef("NDEFMessage")}} object containing the received message.

Value

An {{domxref("NDEFMessage")}} object.

Examples

This example shows how to create a convenience function that reads a single tag and then stops polling, saving battery life by cutting unneeded work. The example could easily be extended to time out after a given amount of milliseconds.

js
const ndefReader = new NDEFReader();

function read() {
  return new Promise((resolve, reject) => {
    const controller = new AbortController();
    controller.signal.onabort = reject;
    ndefReader.addEventListener(
      "reading",
      (event) => {
        controller.abort();
        resolve(event);
      },
      { once: true },
    );
    ndefReader.scan({ signal: controller.signal }).catch((err) => reject(err));
  });
}

read().then(({ serialNumber }) => {
  console.log(serialNumber);
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}