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.