BroadcastChannel

Baseline Widely available

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

Note: This feature is available in Web Workers.

Giao diện BroadcastChannel biểu diễn một kênh có tên mà bất kỳ browsing context nào thuộc cùng một origin đều có thể đăng ký theo dõi. Giao diện này cho phép giao tiếp giữa các tài liệu khác nhau (trong các cửa sổ, thẻ, frame hoặc iframe khác nhau) có cùng nguồn gốc. Thông điệp được phát đi thông qua sự kiện message kích hoạt trên mọi đối tượng BroadcastChannel đang lắng nghe kênh đó, ngoại trừ đối tượng đã gửi thông điệp.

EventTarget BroadcastChannel

Hàm tạo

BroadcastChannel()

Tạo một đối tượng liên kết tới kênh có tên đã chỉ định.

Thuộc tính thể hiện

Giao diện này cũng kế thừa các thuộc tính từ giao diện cha EventTarget.

BroadcastChannel.name Read only

Trả về một chuỗi là tên của kênh.

Phương thức thể hiện

Giao diện này cũng kế thừa các phương thức từ giao diện cha EventTarget.

BroadcastChannel.postMessage()

Gửi thông điệp, thuộc bất kỳ kiểu đối tượng nào, tới từng đối tượng BroadcastChannel đang lắng nghe cùng một kênh.

BroadcastChannel.close()

Đóng đối tượng kênh, cho biết nó sẽ không nhận thêm thông điệp mới nào nữa và cho phép nó cuối cùng được bộ gom rác thu hồi.

Sự kiện

Giao diện này cũng kế thừa các sự kiện từ giao diện cha EventTarget.

message

Kích hoạt khi một thông điệp đến trên kênh. Cũng có thể truy cập qua thuộc tính onmessage.

messageerror

Kích hoạt khi một thông điệp đến nhưng không thể giải tuần tự. Cũng có thể truy cập qua thuộc tính onmessageerror.

Thông số kỹ thuật

Specification
HTML
# broadcasting-to-other-browsing-contexts

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

Xem thêm