RTCDataChannel: message Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("message", (event) => {});

onmessage = (event) => {};

Ein MessageEvent. Erbt von Event.

Erbt auch Eigenschaften von seiner Elternschnittstelle, Event.

MessageEvent.data Nur lesbar

Die vom Nachrichtensender gesendeten Daten.

MessageEvent.origin Nur lesbar

Ein String, der den Ursprung des Nachrichtensenders repräsentiert.

MessageEvent.lastEventId Nur lesbar

Ein String, der eine eindeutige ID für das Ereignis darstellt.

MessageEvent.source Nur lesbar

Eine Referenz auf den Nachrichtensender, eines der WindowProxy, MessagePort oder ServiceWorker.

MessageEvent.ports Nur lesbar

Ein Array von MessagePort-Objekten, das die Ports darstellt, die mit dem Kanal verbunden sind, über den die Nachricht gesendet wird (wo zutreffend, z. B. in der Kanalkommunikation oder beim Senden einer Nachricht an einen gemeinsamen Worker).

Für ein gegebenes RTCDataChannel, dc, das für eine Peer-Verbindung mit seiner createDataChannel()-Methode erstellt wurde, richtet dieser Code einen Handler für eingehende Nachrichten ein und bearbeitet sie, indem er die in der Nachricht enthaltenen Daten als neues <p> (Absatz)-Element zum aktuellen Dokument hinzufügt.

dc.addEventListener(
  "message",
  (event) => {
    let newParagraph = document.createElement("p");
    let textNode = document.createTextNode(event.data);
    newParagraph.appendChild(textNode);

    document.body.appendChild(newParagraph);
  },
  false,
);

Zuerst erstellen wir das neue Absatz-Element und fügen die Nachrichtendaten als neuen Textknoten hinzu. Dann fügen wir den neuen Absatz am Ende des Body-Dokuments an.

Sie können auch die onmessage-Ereignishandler-Eigenschaft eines RTCDataChannel-Objekts verwenden, um den Ereignishandler festzulegen:

dc.onmessage = (event) => {
  let newParagraph = document.createElement("p");
  let textNode = document.createTextNode(event.data);
  newParagraph.appendChild(textNode);

  document.body.appendChild(newParagraph);
};

• WebRTC-API
• Ein einfaches RTCDataChannel-Beispiel
• Verwandte Ereignisse: open, close, und error
• RTCDataChannel.send()