BroadcastChannel

Baseline 2022

Newly available

Since March 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Интерфейс BroadcastChannel представляет собой именованный канал, на который можно подписаться из любого контекста просмотра данного источника. Это позволяет настроить коммуникацию между разными документами (в разных окнах, вкладках, фреймах и т.д.) одного источника. Сообщения распространяются с помощью события message, выстреливающего для всех объектов BroadcastChannel, слушающих этот канал.

Примечание: Эта возможность доступна в Web Workers.

Конструктор

BroadcastChannel() (en-US): Создаёт объект, связанный с именованным каналом.

Свойства

Этот интерфейс также наследует свойства от своего родителя, EventTarget.

BroadcastChannel.name (en-US): Возвращает DOMString, имя канала.

Обработчики событий

BroadcastChannel.onmessage (en-US): event handler свойство, определяющее функцию, которая будет запущена, когда произойдёт вызов события message на этом объекте.
BroadcastChannel.onmessageerror (en-US): event handler, который вызывается, когда приходит MessageEvent (en-US) типа MessageError — когда приходит сообщение, которое не может быть десереализовано.

Методы

Этот интерфейс также наследует свойства от своего родителя,EventTarget.

BroadcastChannel.postMessage(): Отправляет сообщение любого типа объекта всем объектам BroadcastChannel, прослушивающим данный канал.
BroadcastChannel.close() (en-US): Закрывает объект канала, указывая, что тот больше не будет получать новые сообщения, и позволяет сборщику мусора уничтожить его.

Спецификации

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

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также

Another, more heavyweight, way of communicating between browser contexts: ServiceWorker.
Broadcast Channel API overview (en-US)