RTCDataChannel: close-Event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Das close-Ereignis wird an den onclose Ereignishandler einer RTCDataChannel-Instanz gesendet, wenn der Datentransport für den Datenkanal geschlossen wurde. Bevor weitere Daten mit RTCDataChannel übertragen werden können, muss eine neue 'RTCDataChannel'-Instanz erstellt werden.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandlereigenschaft.

js
addEventListener("close", (event) => { })

onclose = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Dieses Beispiel richtet einen Handler für das close-Ereignis des RTCDataChannel namens dc ein; seine Aufgabe in diesem Beispiel besteht darin, die Benutzerschnittstellenelemente so zu aktualisieren, dass angezeigt wird, dass kein Anruf mehr im Gange ist, und dass ein neuer Anruf gestartet werden kann.

js
dc.addEventListener(
  "close",
  (ev) => {
    messageInputBox.disabled = true;
    sendButton.disabled = true;
    connectButton.disabled = false;
    disconnectButton.disabled = true;
  },
  false,
);

Alles, was dieser Code als Reaktion auf das close-Ereignis tut, ist, ein Eingabefeld und dessen "Senden"-Schaltfläche zu deaktivieren und die Schaltfläche zu aktivieren, die zum Starten eines Anrufs verwendet wird (während die Schaltfläche zum Beenden eines Anrufs deaktiviert wird).

Sie können auch die onclose Ereignishandlereigenschaft verwenden, um einen Handler für close-Ereignisse festzulegen:

js
dc.onclose = (ev) => {
  messageInputBox.disabled = true;
  sendButton.disabled = true;
  connectButton.disabled = false;
  disconnectButton.disabled = true;
};

Spezifikationen

Specification
WebRTC: Real-Time Communication in Browsers
# event-datachannel-close
WebRTC: Real-Time Communication in Browsers
# dom-rtcdatachannel-onclose

Browser-Kompatibilität

Siehe auch