RTCDataChannel: message-Ereignis

Syntax

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

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

onmessage = (event) => { }

Ereignistyp

Ein MessageEvent. Erbt von Event.

Beispiele

Für ein gegebenes RTCDataChannel, dc, das für eine Peer-Verbindung unter Verwendung der Methode createDataChannel() erstellt wurde, setzt dieser Code einen Handler für eingehende Nachrichten auf und verarbeitet diese, indem die im Ereignis enthaltenen Daten als neues <p>-Element (Absatz) in das aktuelle Dokument eingefügt werden.

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

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

Wir erstellen zunächst das neue Absatz-Element und fügen die Nachrichtendaten als neuen Textknoten hinzu. Dann fügen wir den neuen Absatz an das Ende des Dokumentkörpers an.

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

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()