NDEFMessage: records Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die Eigenschaft records der NDEFMessage-Schnittstelle repräsentiert eine Liste von NDEFRecord-Objekten, die in der NDEF-Nachricht vorhanden sind.

Wert

Eine Liste von NDEFRecord-Objekten, die die in der Nachricht aufgezeichneten Daten darstellen.

Beispiele

Das folgende Beispiel zeigt, wie der Inhalt einer NDEF-Nachricht gelesen wird. Es wird zunächst ein Ereignishandler für onreading eingerichtet, dem eine Instanz von NDEFReadingEvent übergeben wird. Ein NDEFMessage-Objekt wird aus NDEFReadingEvent.message zurückgegeben. Es wird über message.records iteriert und jeder Datensatz basierend auf seinem Nachrichtentyp verarbeitet. Das Datenmitglied ist ein DataView, das den Umgang mit in UTF-16 kodierten Daten ermöglicht.

js
ndefReaderInst.onreading = (event) => {
  const ndefMessage = event.message;
  for (const record of ndefMessage.records) {
    console.log(`Record type:  ${record.recordType}`);
    console.log(`MIME type:    ${record.mediaType}`);
    console.log(`Record id:    ${record.id}`);
    switch (record.recordType) {
      case "text":
        // TODO: Read text record with record data, lang, and encoding.
        break;
      case "url":
        // TODO: Read URL record with record data.
        break;
      default:
      // TODO: Handle other records with record data.
    }
  }
};

Spezifikationen

Specification
Web NFC API
# dom-ndefmessage-records

Browser-Kompatibilität

BCD tables only load in the browser