Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

js
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.

js
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:

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