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.
Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.
Die error-Schreibgeschützte Eigenschaft des RTCErrorEvent-Interfaces enthält ein RTCError-Objekt, das die WebRTC-spezifischen Details des Fehlers beschreibt.
Wert
Ein RTCError-Objekt.
Beispiele
Grundlegende Verwendung
In diesem Beispiel wird ein Handler für das RTCDataChannel-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 die errorDetail-Eigenschaft, die den Wert sdp-syntax-error besitzt —, wird eine Nachrichtenzeichenfolge konstruiert, um die Fehlermeldung und die SDP-Nachrichtenzeilennummer, in der der Fehler aufgetreten ist, darzustellen. Diese Nachricht wird dann mit einer Funktion namens showMyAlertMessage() angezeigt, die als Platzhalter für den jeweiligen Ausgabemechanismus dient, den dieser Code verwenden könnte.
Jeder andere Fehler wird als terminal behandelt und führt dazu, dass eine Funktion terminateMyConnection() 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:
dataChannel.onerror = (event) => {
let error = event.error;
/* and so forth */
};
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcerrorevent-error |