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.

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/pt-br/web/api/broadcast_channel_api/index.md)

A interface BroadcastChannel representa um canal com um nome em que qualquer browsing context (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 unsupported templ: event acionado em todos objetos do tipo BroadcastChannel que estão ouvindo o canal.

Nota: This feature is available in Web Workers.

Construtor

BroadcastChannel()

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

Retorna um DOMString, o nome do canal.

Event handlers

BroadcastChannel.onmessage

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

BroadcastChannel.onmessageerror

Uma chamada unsupported templ: event quando um MessageEvent 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()

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

BroadcastChannel.close()

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