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

CKTIS / JavaScript

MessagePort — um ponto terminal de um canal de mensagens

MessagePort é um dos dois pontos terminais de um canal bidirecional. Permite a transmissão assíncrona de dados e objetos transferíveis entre partes de código ligadas.

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 { port1, port2 } = new MessageChannel();
port1.postMessage(message);
port1.postMessage(message, transfer);
port1.postMessage(message, { transfer });
port2.addEventListener("message", handler);
port2.start();
port1.close();
port2.close();

MessagePort é uma interface da Web API definida pelo HTML, não pelo ECMAScript. Não é criada com new MessagePort(): new MessageChannel() fornece as portas ligadas port1 e port2. Uma mensagem enviada por uma porta chega à outra como um evento message; o conteúdo pode ser lido através de event.data.

postMessage() coloca a entrega numa fila, em vez de chamar o recetor de forma síncrona. Os dados são sujeitos a clonagem estruturada. Uma lista transfer opcional transfere objetos transferíveis em vez de os copiar; também é possível transferir a própria porta. O objeto do lado do emissor deixa então de poder ser utilizado.

Com addEventListener("message", handler), chama start() na porta recetora. A atribuição de onmessage inicia automaticamente a receção. DataCloneError indica um erro de serialização ou da lista de transferência; messageerror assinala uma falha de desserialização no recetor. Quando a comunicação terminar, fecha as portas com close().

O exemplo utiliza ambas as portas dentro da mesma página. Esta é uma API de navegador; a presença do Node 24 num repositório não comprova o suporte em navegadores.

Exemplos

(() => {
  const { port1, port2 } = new MessageChannel();

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

  port1.postMessage({ value: 42 });
  console.log("sent");
})();

Resultado

sent
received: 42

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