RTCDataChannel: open-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Das WebRTC open-Ereignis wird an den onopen-Ereignis-Handler eines RTCDataChannel-Objekts gesendet, wenn das zugrunde liegende Transportmittel zum Senden und Empfangen von Nachrichten des Datenkanals geöffnet oder erneut geöffnet wird.
Dieses Ereignis ist nicht abbruchfähig und blubbert nicht.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("open", (event) => { })
onopen = (event) => { }
Ereignistyp
Ein RTCDataChannelEvent. Erbt von Event.
Ereigniseigenschaften
Erbt außerdem Eigenschaften von der übergeordneten Schnittstelle Event.
channelSchreibgeschützt-
Gibt den
RTCDataChannelzurück, der mit dem Ereignis verknüpft ist.
Beispiele
Dieses Beispiel fügt einem RTCDataChannel dc einen Handler für das open-Ereignis hinzu, der die Benutzeroberfläche anpasst, um anzuzeigen, dass ein Chatfenster bereit zur Nutzung ist, nachdem eine Verbindung hergestellt wurde. Es aktiviert das Nachrichten-Eingabefeld und die Senden-Schaltfläche sowie die Trennungs-Schaltfläche und deaktiviert die Verbindungs-Schaltfläche. Schließlich wird das Nachrichten-Eingabefeld fokussiert, damit der Benutzer sofort mit dem Tippen beginnen kann.
dc.addEventListener("open", (ev) => {
messageInputBox.disabled = false;
sendMessageButton.disabled = false;
disconnectButton.disabled = false;
connectButton.disabled = true;
messageInputBox.focus();
});
Dies kann auch durch direktes Setzen des Werts der onopen-Ereignis-Handler-Eigenschaft des Kanals erfolgen.
dc.onopen = (ev) => {
messageInputBox.disabled = false;
sendMessageButton.disabled = false;
disconnectButton.disabled = false;
connectButton.disabled = true;
messageInputBox.focus();
};
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers> # event-datachannel-open> |
| WebRTC: Real-Time Communication in Browsers> # dom-rtcdatachannel-onopen> |
Browser-Kompatibilität
Siehe auch
- WebRTC-API
- Ein einfaches RTCDataChannel-Beispiel
- Verwandte Ereignisse:
message,closeunderror