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

CKTIS / JavaScript

MessageChannel — komunikace pomocí propojených portů

MessageChannel vytváří dva propojené porty pro asynchronní obousměrnou výměnu zpráv. Naučte se přijímat události, spustit doručování, klonovat data a porty zavřít.

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 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() vytvoří dva propojené objekty MessagePort, které jsou dostupné prostřednictvím vlastností pouze pro čtení port1 a port2. Zpráva odeslaná jedním portem dorazí na druhý jako událost message; její data lze přečíst z event.data. Doručování je asynchronní a nepřeruší právě probíhající úlohu.

Přiřazení onmessage automaticky spustí přijímací frontu portu. Při použití addEventListener('message', handler) zavolejte start() na přijímajícím portu. Příklad nejprve vypíše sent a potom received: hello; po přijetí zprávy zavře oba porty pomocí close().

postMessage() používá strukturované klonování, nikoli sdílení běžných objektů. Data, která nelze klonovat, způsobí DataCloneError. Volitelný seznam přenosu přenese podporované objekty místo jejich kopírování; samotný MessagePort lze přenést do jiného okna nebo workeru.

Jde o Web API definované standardem HTML, nikoli o funkci určité edice ECMAScriptu. Konstruktor je dostupný v kontextech Window a Worker a podporují ho současné prohlížečové enginy. Přítomnost Node 24 v repozitáři nedokládá podporu v cílovém prohlížeči.

Příklady

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

Výsledek

sent
received: hello

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