RTCErrorEvent: error-Eigenschaft
Baseline
2026
Neu verfügbar
Seit April 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die error schreibgeschützte Eigenschaft des RTCErrorEvent-Interfaces enthält ein RTCError-Objekt, das die für WebRTC spezifischen Details des Fehlers beschreibt.
Wert
Ein RTCError-Objekt.
Beispiele
Grundlegende Nutzung
In diesem Beispiel wird ein Handler für ein RTCDataChannel's error-Ereignis eingerichtet.
dataChannel.addEventListener("error", (event) => {
let error = event.error;
if (error.errorDetail === "sdp-syntax-error") {
const errLine = error.sdpLineNumber;
const errMessage = error.message;
const alertMessage = `A syntax error occurred interpreting line ${errLine} of the SDP: ${errMessage}`;
showMyAlertMessage("Data Channel Error", alertMessage);
} else {
terminateMyConnection();
}
});
Wenn der Fehler ein SDP-Syntaxfehler ist — angezeigt durch seine errorDetail-Eigenschaft, die den Wert sdp-syntax-error hat — wird eine Nachrichtenzeichenkette erstellt, um die Fehlermeldung und die SDP-Nachrichtenzeilennummer, bei der der Fehler aufgetreten ist, zu präsentieren. Diese Nachricht wird dann mit einer Funktion namens showMyAlertMessage() angezeigt, die als Platzhalter für welchen Ausgabemechanismus auch immer dieser Code verwendet, fungiert.
Alle anderen Fehler werden als kritisch betrachtet, was dazu führt, dass eine terminateMyConnection()-Funktion aufgerufen wird.
Das obige Beispiel verwendet addEventListener(), um den Handler für error-Ereignisse hinzuzufügen. Sie können auch die onerror-Ereignishandler-Eigenschaft des RTCDataChannel-Objekts verwenden, so wie hier:
dataChannel.onerror = (event) => {
let error = event.error;
/* and so forth */
};
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcerrorevent-error |