Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori