RTCDataChannel: message-Ereignis

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

Alternativ können Sie den Handler der Ereignishandler-Eigenschaft der Schnittstelle zuweisen:

onmessage = (event) => { }

Ereignistyp

Ein MessageEvent. Erbt von Event.

Beispiele

Für einen gegebenen RTCDataChannel, dc, der für eine Peer-Verbindung mit deren Methode createDataChannel() erstellt wurde, richtet dieser Code einen Handler für eingehende Nachrichten ein. Er verarbeitet sie, indem er die in der Nachricht enthaltenen Daten als neues <p>-Element (Absatz) 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);
});

Zuerst erstellen wir das neue Absatzelement und fügen ihm die Nachrichtendaten als neuen Textknoten hinzu. Anschließend hängen wir den neuen Absatz an das Ende des Dokument-Bodys an.

Sie können den Ereignishandler auch über die onmessage-Ereignishandler-Eigenschaft eines RTCDataChannel-Objekts festlegen. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onmessage hinzugefügte Ereignis-Listener ersetzt werden:

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

  document.body.appendChild(newParagraph);
};

Spezifikationen

Browser-Kompatibilität

Siehe auch

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