RTCDtlsTransport: error event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Một RTCDtlsTransport nhận sự kiện error khi xảy ra lỗi cấp transport trên RTCPeerConnection.

Sự kiện này không thể hủy và không nổi bọt.

Cú pháp

Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt thuộc tính xử lý sự kiện.

js
addEventListener("error", (event) => { })

onerror = (event) => { }

Kiểu sự kiện

Một RTCErrorEvent. Kế thừa từ Event.

Event RTCErrorEvent

Thuộc tính sự kiện

Ngoài các thuộc tính chuẩn có sẵn trên giao diện Event, RTCErrorEvent cũng bao gồm:

error Read only

Một đối tượng RTCError chỉ ra lỗi đã xảy ra; đối tượng này bao gồm loại lỗi đã xảy ra, thông tin về nơi xảy ra lỗi (chẳng hạn như dòng số nào trong SDP hoặc mã nguyên nhân SCTP nào là vấn đề).

Mô tả

Các lỗi cấp transport sẽ có một trong các giá trị sau cho thuộc tính RTCError errorDetail của lỗi đã chỉ định:

dtls-failure

Việc thỏa thuận kết nối DTLS thất bại, hoặc kết nối bị chấm dứt với một lỗi nghiêm trọng. message của lỗi chứa thông tin chi tiết về bản chất của lỗi. Nếu một lỗi nghiêm trọng được nhận, thuộc tính receivedAlert của đối tượng lỗi được đặt thành giá trị của cảnh báo DTLSL đã nhận. Mặt khác, nếu một lỗi nghiêm trọng được gửi, sentAlert được đặt thành giá trị của cảnh báo.

fingerprint-failure

Chứng chỉ từ xa cho RTCDtlsTransport không khớp với bất kỳ fingerprint nào được liệt kê trong SDP. Nếu peer từ xa không thể khớp chứng chỉ cục bộ với các fingerprint được cung cấp, lỗi này không xảy ra, mặc dù tình huống này có thể dẫn đến lỗi dtls-failure.

Ví dụ

Trong ví dụ này, thuộc tính xử lý sự kiện onerror được sử dụng để đặt trình xử lý cho sự kiện error.

js
transport.onerror = (ev) => {
  const err = ev.error;

  // …
};

Note:RTCError không phải là một trong các lỗi kế thừa, giá trị của code luôn là 0.

Thông số kỹ thuật

This feature does not appear to be defined in any specification.

Tương thích trình duyệt

Xem thêm