Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

MessageChannel — comunicação através de portas emparelhadas

MessageChannel cria duas portas ligadas para trocar mensagens de forma assíncrona e bidirecional. Aprende a receber eventos, iniciar a entrega, clonar dados e fechar as portas.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

const channel = new MessageChannel();
channel.port2.onmessage = (event) => {
  /* event.data */
  channel.port1.close();
  channel.port2.close();
};
// With addEventListener('message', handler), call port.start().
channel.port1.postMessage(value);

new MessageChannel() cria dois objetos MessagePort ligados, acessíveis através das propriedades só de leitura port1 e port2. Uma mensagem enviada por uma porta chega à outra como um evento message; os dados podem ser lidos em event.data. A entrega é assíncrona e não interrompe a tarefa atual.

Atribuir onmessage inicia automaticamente a fila de receção da porta. Com addEventListener('message', handler), chama start() na porta recetora. O exemplo apresenta primeiro sent e depois received: hello; após receber a mensagem, fecha ambas as portas com close().

postMessage() utiliza clonagem estruturada, em vez de partilhar objetos comuns. Dados que não podem ser clonados provocam DataCloneError. Uma lista de transferência opcional transfere os objetos suportados em vez de os copiar; o próprio MessagePort pode ser transferido para outra janela ou para um worker.

Esta é uma API Web definida por HTML, não uma funcionalidade de uma edição específica de ECMAScript. O construtor está disponível nos contextos Window e Worker e é suportado pelos motores de browser atuais. A presença de Node 24 num repositório não comprova o suporte no browser de destino.

Exemplos

(() => {
  const channel = new MessageChannel();

  channel.port2.addEventListener('message', (event) => {
    console.log(`received: ${event.data.text}`);
    channel.port1.close();
    channel.port2.close();
  }, { once: true });
  channel.port2.start();

  channel.port1.postMessage({ text: 'hello' });
  console.log('sent');
})();

Resultado

sent
received: hello

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes