Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

MessagePort — koncový bod komunikačního kanálu

MessagePort je jeden ze dvou koncových bodů obousměrného kanálu. Umožňuje asynchronní přenos dat a přenositelných objektů mezi propojenými částmi kódu.

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

Syntaxe

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 rozhraní Web API definované standardem HTML, nikoli ECMAScriptem. Nevytváří se pomocí new MessagePort(): new MessageChannel() poskytne propojené porty port1 a port2. Zpráva odeslaná jedním portem dorazí na druhý jako událost message; její obsah lze přečíst přes event.data.

postMessage() zařadí doručení do fronty, místo aby příjemce zavolalo synchronně. Data procházejí strukturovaným klonováním. Volitelný seznam transfer přenáší přenositelné objekty, místo aby je kopíroval; přenést lze také samotný port. Objekt na straně odesílatele pak přestane být použitelný.

Při použití addEventListener("message", handler) zavolejte na přijímajícím portu start(). Přiřazení onmessage zahájí příjem automaticky. DataCloneError označuje chybu serializace nebo seznamu přenosu; messageerror signalizuje neúspěšnou deserializaci u příjemce. Po dokončení komunikace porty zavřete pomocí close().

Příklad používá oba porty na jedné stránce. Jde o API prohlížeče; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížečích.

Příklady

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

Výsledek

sent
received: 42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje