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.

A interface BroadcastChannel representa um canal com um nome em que qualquer browsing context (en-US) (contexto de navegação) de uma determinada origin (origem) pode assinar. Permite a comunicação entre diferentes documentos (em diferentes janelas, abas, frames ou iframes) da mesma origin. As mensagens são transmitidas através de um evento message acionado em todos objetos do tipo BroadcastChannel que estão ouvindo o canal.

Note: This feature is available in Web Workers.

Construtor

BroadcastChannel() (en-US)

Cria um objeto, no qual faz o vínculo com um canal nomeado.

Propriedades

Essa interface também herda propriedades de seu pai, EventTarget.

BroadcastChannel.name (en-US)

Retorna um DOMString, o nome do canal.

Event handlers

BroadcastChannel.onmessage (en-US)

Uma propriedade event handler que específica a função a ser executada quando um evento message é acionado a este objeto.

BroadcastChannel.onmessageerror (en-US)

Uma chamada event handler quando um MessageEvent (en-US) do tipo MessageError é disparado - isto é, quando recebe uma mensagem que não pode ser desserializada.

Métodos

Essa interface também herda métodos de seu pai, EventTarget.

BroadcastChannel.postMessage() (en-US)

Envia a mensagem, de qualquer tipo de objeto, para cada objeto BroadcastChannel ouvindo o mesmo canal.

BroadcastChannel.close() (en-US)

Fecha o objeto do canal, indicando que ele não receberá novas mensagens e eventualmente será descartado.

Especificações

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

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também