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 Januar 2020.
Das close
-Event 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 blubbert nicht.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("close", (event) => { })
onclose = (event) => { }
Ereignistyp
Ein generisches Event
.
Beispiele
Dieses Beispiel richtet einen Handler für das close
-Event für das RTCDataChannel
namens dc
ein. In diesem Beispiel besteht seine Aufgabe darin, die Benutzeroberflächenelemente so zu aktualisieren, dass sie widerspiegeln, dass kein laufender Anruf mehr vorhanden ist, und einen neuen Anruf zu ermöglichen.
dc.addEventListener("close", (ev) => {
messageInputBox.disabled = true;
sendButton.disabled = true;
connectButton.disabled = false;
disconnectButton.disabled = true;
});
Der gesamte Code bewirkt als Reaktion auf das Empfangs des close
-Ereignisses, dass ein Eingabefeld und dessen "Senden"-Schaltfläche deaktiviert werden und die Schaltfläche, die verwendet wird, um einen Anruf zu starten, aktiviert wird (während diejenige, die einen Anruf beendet, deaktiviert wird).
Sie können auch die onclose
-Ereignishandler-Eigenschaft verwenden, um einen Handler für close
-Ereignisse zu setzen:
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
Loading…
Siehe auch
- WebRTC API
- Ein einfaches RTCDataChannel-Beispiel
- Verwandte Ereignisse:
open
,message
underror