CKTIS / JavaScript
MessagePort — krajnja točka kanala za poruke
MessagePort jedna je od dviju krajnjih točaka dvosmjernog kanala. Omogućuje asinkroni prijenos podataka i prenosivih objekata između povezanih dijelova koda.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 je sučelje Web API-ja definirano u HTML-u, a ne u ECMAScriptu. Ne stvara se pomoću new MessagePort(): new MessageChannel() daje povezane portove port1 i port2. Poruka poslana jednim portom stiže na drugi kao događaj message; njezin se sadržaj čita putem event.data.
postMessage() stavlja isporuku u red čekanja umjesto da sinkrono poziva primatelja. Podaci se strukturno kloniraju. Neobavezan popis transfer prenosi prenosive objekte umjesto da ih kopira; može se prenijeti i sam port. Objekt na strani pošiljatelja tada se više ne može upotrebljavati.
Uz addEventListener("message", handler) pozovite start() na prijamnom portu. Dodjela vrijednosti za onmessage automatski pokreće primanje. DataCloneError označava pogrešku serializacije ili popisa za prijenos; messageerror signalizira neuspjelu deserijalizaciju kod primatelja. Kad komunikacija završi, zatvorite portove pomoću close().
Primjer upotrebljava oba porta unutar jedne stranice. Ovo je API preglednika; prisutnost Node 24 u repozitoriju ne dokazuje podršku u pregledniku.
Primjeri
(() => {
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");
})();Rezultat
sent received: 42
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.