RTCError: RTCError() Konstruktor

Syntax

new RTCError(options)
new RTCError(options, message)

Parameter

options

Ein Objekt, das die Details des spezifischen Fehlers in einem RTCErrorEvent bereitstellt. Das Objekt hat die folgenden Eigenschaften:

errorDetail

Ein String, der den WebRTC-spezifischen Fehlercode angibt, der den Typ des aufgetretenen Fehlers identifiziert. Dies wird eines der folgenden sein:

data-channel-failure

Der RTCDataChannel der Verbindung ist fehlgeschlagen.

dtls-failure

Die Aushandlung der DTLS-Verbindung ist fehlgeschlagen oder die Verbindung wurde mit einem fatalen Fehler beendet. Die message des Fehlers enthält Details zur Art des Fehlers.

• Wenn ein fataler Fehler empfangen wird, setzen Sie receivedAlert auf den Wert des empfangenen DTLS-Alerts.
• Wenn ein fataler Fehler gesendet wurde, setzen Sie sentAlert auf den Wert des Alerts.

fingerprint-failure

Das entfernte Zertifikat für den RTCDtlsTransport entsprach keinem der in der SDP-Nachricht aufgeführten Fingerprints. Sollte der entfernte Peer das lokale Zertifikat nicht mit den bereitgestellten Fingerprints abgleichen können, wird dieser Fehler nicht ausgelöst, kann jedoch stattdessen in einem dtls-failure-Fehler resultieren.

hardware-encoder-error

Der Hardware-Encoder unterstützt die angegebenen Konfigurationsparameter nicht.

hardware-encoder-not-available

Die Hardware-Encoder-Ressourcen, die erforderlich sind, um die angeforderte Operation auszuführen, sind nicht verfügbar.

sctp-failure

Die SCTP-Aushandlung ist fehlgeschlagen oder die Verbindung wurde mit einem fatalen Fehler beendet. Der SCTP-Ursachencode sollte in sctpCauseCode gesetzt werden. SCTP-Fehlerursachencodes 1-13 sind in der SCTP-Spezifikation definiert: RFC 4960, Abschnitt 3.3.10.

sdp-syntax-error

Die SDP-Syntax ist ungültig. Die SDP-Nachrichtenzeilennummer, bei der der Fehler entdeckt wurde, sollte in sdpLineNumber gesetzt werden.

receivedAlert Optional

Ein positiver Integer-Wert, der einen fatalen DTLS-Fehler anzeigt, der aus dem Netzwerk empfangen wurde. Nur gesetzt, wenn der errorDetail-String dtls-failure ist.

sctpCauseCode Optional

Ein Integer, der den SCTP-Ursachencode spezifiziert, der die Ursache der fehlgeschlagenen SCTP-Aushandlung angibt. Sollte nur gesetzt werden, wenn errorDetail sctp-failure ist.

sdpLineNumber Optional

Ein Integer, der die SDP-Nachrichtenzeilennummer identifiziert, bei der ein Syntaxfehler aufgetreten ist. Nur gesetzt, wenn errorDetail sdp-syntax-error ist.

sentAlert Optional

Ein positiver Integer, der einen fatalen DTLS-Fehler anzeigt, der von diesem Gerät gesendet wurde. Nur gesetzt, wenn errorDetail dtls-failure ist.

message Optional

Ein String für die Fehlermeldung. Standardmäßig ist dies der leere String ("").

Rückgabewert

Eine neu erstellte RTCError Objektinstanz.

Verwendungshinweise

Dieser Konstruktor führt keine vollständige Validierung des angegebenen candidateInfo-Objekts oder Strings durch.

Spezifikationen

Browser-Kompatibilität