Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

MessagePort — un endpoint di un canale di messaggi

MessagePort è uno dei due endpoint di un canale bidirezionale. Consente la trasmissione asincrona di dati e oggetti trasferibili tra parti di codice collegate.

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

Sintassi

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 è un’interfaccia della Web API definita da HTML, non da ECMAScript. Non si crea con new MessagePort(): new MessageChannel() fornisce le porte collegate port1 e port2. Un messaggio inviato tramite una porta raggiunge l’altra come evento message; il contenuto si legge con event.data.

postMessage() mette in coda la consegna invece di chiamare il destinatario in modo sincrono. I dati sono sottoposti a clonazione strutturata. Un elenco transfer facoltativo trasferisce gli oggetti trasferibili anziché copiarli; è possibile trasferire anche una porta. L’oggetto sul lato mittente diventa quindi inutilizzabile.

Con addEventListener("message", handler), chiama start() sulla porta ricevente. Assegnando onmessage, la ricezione inizia automaticamente. DataCloneError indica un errore di serializzazione o dell’elenco di trasferimento; messageerror segnala un errore di deserializzazione sul destinatario. Al termine della comunicazione, chiudi le porte con close().

L’esempio usa entrambe le porte all’interno della stessa pagina. Questa è un’API del browser; la presenza di Node 24 in un repository non dimostra il supporto nei browser.

Esempi

(() => {
  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");
})();

Risultato

sent
received: 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti