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 vor der Verwendung auf produktiven Webseiten.

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

Wert

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

Beispiele

Das folgende Beispiel zeigt, wie der Inhalt einer NDEF-Nachricht gelesen wird. Zuerst wird ein Ereignis-Handler für onreading eingerichtet, der eine Instanz von NDEFReadingEvent übergeben bekommt. Ein NDEFMessage-Objekt wird von NDEFReadingEvent.message zurückgegeben. Es durchläuft message.records und verarbeitet jedes record basierend auf seinem Nachrichtentyp. Das Datenmitglied ist ein DataView, das es ermöglicht, mit in UTF-16 kodierten Daten umzugehen.

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
# dom-ndefmessage-records

Browser-Kompatibilität