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.