WebRTCwindow_and_dedicated
The RTCError() constructor creates and returns a new RTCError object instance.
Syntax
new RTCError(options)
new RTCError(options, message)
Parameters
-
options- : An object providing the details of the specific error in an
RTCErrorEvent. The object has the following properties:-
errorDetail- : A string specifying the WebRTC-specific error code identifying the type of error that occurred.
This will be one of:
data-channel-failure- : The connection's RTCDataChannel has failed.
dtls-failure- : The negotiation of the DTLS connection failed, or the connection was terminated with a fatal error.
The error's DOMException.message contains details about the nature of the error.
- If a fatal error is received, set
receivedAlertto the value of the received DTLS alert. - If a fatal error was sent, set
sentAlertto the alert's value.
- If a fatal error is received, set
- : The negotiation of the DTLS connection failed, or the connection was terminated with a fatal error.
The error's DOMException.message contains details about the nature of the error.
fingerprint-failure- : The remote certificate for the RTCDtlsTransport didn't match any of the fingerprints listed in the SDP message.
If the remote peer can't match the local certificate against the provided fingerprints, this error doesn't occur, though this situation may result instead in a
dtls-failureerror.
- : The remote certificate for the RTCDtlsTransport didn't match any of the fingerprints listed in the SDP message.
If the remote peer can't match the local certificate against the provided fingerprints, this error doesn't occur, though this situation may result instead in a
hardware-encoder-error- : The hardware encoder doesn't support the given configuration parameters.
hardware-encoder-not-available- : The hardware encoder resources required to accomplish the requested operation aren't available.
sctp-failure- : The SCTP negotiation has failed, or the connection has terminated with a fatal error.
The SCTP cause code should be set in
sctpCauseCode. SCTP error cause codes 1-13 are defined in the SCTP specification: .
- : The SCTP negotiation has failed, or the connection has terminated with a fatal error.
The SCTP cause code should be set in
sdp-syntax-error- : The SDP syntax is invalid.
The SDP message line number at which the error was detected should be set in
sdpLineNumber.
- : The SDP syntax is invalid.
The SDP message line number at which the error was detected should be set in
- : A string specifying the WebRTC-specific error code identifying the type of error that occurred.
This will be one of:
-
receivedAlert- : A positive integer value indicating a fatal DTLS error that was received from the network.
Only set if the
errorDetailstring isdtls-failure.
- : A positive integer value indicating a fatal DTLS error that was received from the network.
Only set if the
-
sctpCauseCode- : An integer specifying the SCTP cause code that indicates the cause of the failed SCTP negotiation.
This should only be set if
errorDetailissctp-failure.
- : An integer specifying the SCTP cause code that indicates the cause of the failed SCTP negotiation.
This should only be set if
-
sdpLineNumber- : An integer identifying the SDP message line number at which a syntax error occurred.
Only set if
errorDetailissdp-syntax-error.
- : An integer identifying the SDP message line number at which a syntax error occurred.
Only set if
-
sentAlert- : A positive integer indicating a fatal DTLS error that was sent out by this device.
Only set if
errorDetailisdtls-failure.
- : A positive integer indicating a fatal DTLS error that was sent out by this device.
Only set if
-
- : An object providing the details of the specific error in an
-
message- : A string for the error message.
Defaults to the empty string (
"").
- : A string for the error message.
Defaults to the empty string (
Return value
A newly-created RTCError object instance.
Usage notes
This constructor does not do complete validation of the specified candidateInfo object or string.
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
