BroadcastChannel
Интерфейс 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)