CKTIS / JavaScript
MessageChannel — comunicazione tramite porte associate
MessageChannel crea due porte collegate per scambiare messaggi in modo asincrono e bidirezionale. Scopri come ricevere eventi, avviare la consegna, clonare i dati e chiudere le porte.
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 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() crea due oggetti MessagePort collegati, accessibili tramite le proprietà di sola lettura port1 e port2. Un messaggio inviato attraverso una porta raggiunge l’altra come evento message; i dati si leggono da event.data. La consegna è asincrona e non interrompe l’attività corrente.
Assegnare onmessage avvia automaticamente la coda di ricezione della porta. Con addEventListener('message', handler), chiama start() sulla porta ricevente. L’esempio stampa prima sent, poi received: hello; dopo aver ricevuto il messaggio, chiude entrambe le porte con close().
postMessage() usa la clonazione strutturata invece di condividere oggetti ordinari. I dati non clonabili causano DataCloneError. Un elenco di trasferimento facoltativo trasferisce gli oggetti supportati invece di copiarli; anche un MessagePort può essere trasferito a un’altra finestra o a un worker.
Questa è un’API Web definita da HTML, non una funzionalità di una specifica edizione di ECMAScript. Il costruttore è esposto nei contesti Window e Worker ed è supportato dai motori dei browser attuali. La presenza di Node 24 in un repository non dimostra il supporto nel browser di destinazione.
Esempi
(() => {
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');
})();Risultato
sent received: hello
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.