RTCPeerConnection: thuộc tính connectionState

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2023.

Thuộc tính chỉ đọc connectionState của giao diện RTCPeerConnection cho biết trạng thái hiện tại của kết nối ngang hàng bằng cách trả về một trong các giá trị chuỗi sau: new, connecting, connected, disconnected, failed hoặc closed.

Trạng thái này về cơ bản đại diện cho trạng thái tổng hợp của tất cả các luồng truyền tải ICE (thuộc kiểu RTCIceTransport hoặc RTCDtlsTransport) mà kết nối đang dùng.

Khi giá trị của thuộc tính này thay đổi, một sự kiện connectionstatechange sẽ được gửi tới thể hiện RTCPeerConnection.

Giá trị

Một chuỗi biểu diễn trạng thái hiện tại của kết nối. Giá trị có thể là một trong các trạng thái sau:

new: Ít nhất một trong các luồng truyền tải ICE của kết nối (các đối tượng RTCIceTransport hoặc RTCDtlsTransport) đang ở trạng thái new, và không có luồng nào ở các trạng thái sau: connecting, checking, failed, disconnected, hoặc tất cả các luồng của kết nối đều ở trạng thái closed.
connecting: Một hay nhiều luồng truyền tải ICE hiện đang trong quá trình thiết lập kết nối; tức là iceConnectionState của chúng là checking hoặc connected, và không có luồng nào ở trạng thái failed.
connected: Mọi luồng truyền tải ICE được dùng bởi kết nối đều hoặc đang được sử dụng (trạng thái connected hoặc completed) hoặc đã đóng (trạng thái closed); ngoài ra, ít nhất một luồng đang ở trạng thái connected hoặc completed.
disconnected: Ít nhất một trong các luồng truyền tải ICE của kết nối ở trạng thái disconnected và không có luồng nào khác ở các trạng thái: failed, connecting hoặc checking.
failed: Một hay nhiều luồng truyền tải ICE trên kết nối ở trạng thái failed.
closed: RTCPeerConnection đã đóng.

Ví dụ

const peerConnection = new RTCPeerConnection(configuration);

// …

const connectionState = peerConnection.connectionState;

Thông số kỹ thuật

Specification
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-connection-state

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

Xem thêm

Help improve MDN

Learn how to contribute

This page was last modified on Jan 1, 1970 by MDN contributors.

View this page on GitHub • Report a problem with this content