RTCDataChannel: error event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Ein WebRTC error
-Ereignis wird an den onerror
-Ereignishandler eines RTCDataChannel
-Objekts gesendet, wenn auf dem Datenkanal ein Fehler auftritt.
Das RTCErrorEvent
-Objekt bietet Details über den aufgetretenen Fehler; schauen Sie sich diesen Artikel für Einzelheiten an.
Dieses Ereignis ist nicht stornierbar und blubbert nicht.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("error", (event) => {});
onerror = (event) => {};
Ereignistyp
Ein RTCErrorEvent
. Erbt von Event
.
Ereigniseigenschaften
Neben den unten aufgeführten Eigenschaften sind auch die Eigenschaften der übergeordneten Schnittstelle Event
verfügbar.
Beispiele
// Strings for each of the SCTP cause codes found in RFC
// 4960, section 3.3.10:
// https://datatracker.ietf.org/doc/html/rfc4960#section-3.3.10
const sctpCauseCodes = [
"No SCTP error",
"Invalid stream identifier",
"Missing mandatory parameter",
"Stale cookie error",
"Sender is out of resource (i.e., memory)",
"Unable to resolve address",
"Unrecognized SCTP chunk type received",
"Invalid mandatory parameter",
"Unrecognized parameters",
"No user data (SCTP DATA chunk has no data)",
"Cookie received while shutting down",
"Restart of an association with new addresses",
"User-initiated abort",
"Protocol violation",
];
dc.addEventListener(
"error",
(ev) => {
const err = ev.error;
console.error("WebRTC error: ", err.message);
// Handle specific error detail types
switch (err.errorDetail) {
case "sdp-syntax-error":
console.error(" SDP syntax error in line ", err.sdpLineNumber);
break;
case "idp-load-failure":
console.error(
" Identity provider load failure: HTTP error ",
err.httpRequestStatusCode,
);
break;
case "sctp-failure":
if (err.sctpCauseCode < sctpCauseCodes.length) {
console.error(" SCTP failure: ", err.sctpCauseCode);
} else {
console.error(" Unknown SCTP error");
}
break;
case "dtls-failure":
if (err.receivedAlert) {
console.error(" Received DTLS failure alert: ", err.receivedAlert);
}
if (err.sentAlert) {
console.error(" Sent DTLS failure alert: ", err.receivedAlert);
}
break;
}
// Add source file name and line information
console.error(
" Error in file ",
err.filename,
" at line ",
err.lineNumber,
", column ",
err.columnNumber,
);
},
false,
);
Das empfangene Ereignis liefert Details in einem RTCError
-Objekt, das als error
bezeichnet wird; RTCError
ist eine Erweiterung der DOMException
-Schnittstelle. Der name
des Fehlers ist RTCError
und die message
ist eine vom WebRTC-Layer angegebene Fehlermeldung.
Fehlerinformationen werden mit console.error()
an die Konsole ausgegeben. Die message
-Zeichenfolge wird immer ausgegeben, ebenso Informationen über den Namen der Quelldatei, die Zeilennummer und die Spaltennummer, an denen der Fehler auftrat.
Je nach Wert von errorDetail
können jedoch zusätzlich Informationen ausgegeben werden. Jeder Fehlertyp hat unterschiedliche ausgegebene Informationen. Beispielsweise zeigt ein SDP-Syntaxfehler die Zeilennummer des Fehlers innerhalb des SDP an, und ein SCTP-Fehler zeigt eine Nachricht entsprechend dem SCTP-Ursachencode an. Andere Fehlertypen geben entsprechend passende Informationen aus.
Sie können auch einen Ereignishandler für error
-Ereignisse mit der RTCDataChannel
-Schnittstelle und der onerror
-Ereignishandler-Eigenschaft einrichten:
dc.onerror = (ev) => {
const err = ev.error;
// …
};
Hinweis: Da RTCError
nicht zu den veralteten Fehlern gehört, ist der Wert von RTCError.code
immer 0.
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # event-datachannel-error |
WebRTC: Real-Time Communication in Browsers # dom-rtcdatachannel-onerror |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- WebRTC API
- Ein einfaches RTCDataChannel-Beispiel
- Verwandte Ereignisse:
open
,message
undclose