BroadcastChannel
Интерфейс BroadcastChannel
представляет собой именованный канал, на который можно подписаться из любого контекста просмотра данного источника. Это позволяет настроить коммуникацию между разными документами (в разных окнах, вкладках, фреймах и т.д.) одного источника. Сообщения распространяются с помощью события message
, выстреливающего для всех объектов BroadcastChannel
, слушающих этот канал.
Примечание:
Эта возможность доступна в Web Workers.Конструктор
BroadcastChannel()
(en-US)- Создаёт объект, связанный с именованным каналом.
Свойства
Этот интерфейс также наследует свойства от своего родителя, EventTarget
.
BroadcastChannel.name
(en-US)- Возвращает
DOMString
, имя канала. -
Обработчики событий
BroadcastChannel.onmessage
(en-US)EventHandler
(en-US) свойство, определяющее функцию, которая будет запущена, когда произойдёт вызов событияmessage
на этом объекте.BroadcastChannel.onmessageerror
(en-US)EventHandler
(en-US), который вызывается, когда приходитMessageEvent
(en-US) типаMessageError
— когда приходит сообщение, которое не может быть десереализовано.
Методы
Этот интерфейс также наследует свойства от своего родителя,EventTarget
.
BroadcastChannel.postMessage()
- Отправляет сообщение любого типа объекта всем объектам
BroadcastChannel
, прослушивающим данный канал. BroadcastChannel.close()
(en-US)- Закрывает объект канала, указывая, что тот больше не будет получать новые сообщения, и позволяет сборщику мусора уничтожить его.
Спецификации
Specification | Status | Comment |
---|---|---|
HTML Living Standard Определение 'BroadcastChannel' в этой спецификации. |
Живой стандарт | Initial definition. |
Браузерная совместимость
BCD tables only load in the browser
Смотрите также
- Another, more heavyweight, way of communicating between browser contexts:
ServiceWorker
. - Broadcast Channel API overview