大网数据广告活动
Web 标准与前端开发

RTCError: RTCError() constructor

· 52CE 我爱测

The **`RTCError()`** constructor creates and returns a new RTCError object instance.

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 receivedAlert to the value of the received DTLS alert.
              • If a fatal error was sent, set sentAlert to the alert's value.
          • 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-failure error.
          • 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: .
          • sdp-syntax-error
            • : The SDP syntax is invalid. The SDP message line number at which the error was detected should be set in sdpLineNumber.
      • receivedAlert

        • : A positive integer value indicating a fatal DTLS error that was received from the network. Only set if the errorDetail string is dtls-failure.
      • sctpCauseCode

        • : An integer specifying the SCTP cause code that indicates the cause of the failed SCTP negotiation. This should only be set if errorDetail is sctp-failure.
      • sdpLineNumber

        • : An integer identifying the SDP message line number at which a syntax error occurred. Only set if errorDetail is sdp-syntax-error.
      • sentAlert

        • : A positive integer indicating a fatal DTLS error that was sent out by this device. Only set if errorDetail is dtls-failure.
  • message

    • : 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。