CKTIS / JavaScript
MessagePort — koncový bod komunikačného kanála
MessagePort je jeden z dvoch koncových bodov obojsmerného kanála. Umožňuje asynchrónny prenos údajov a prenositeľných objektov medzi prepojenými časťami kódu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 rozhranie Web API definované štandardom HTML, nie ECMAScriptom. Nevytvára sa pomocou new MessagePort(): new MessageChannel() poskytne prepojené porty port1 a port2. Správa odoslaná jedným portom dorazí na druhý ako udalosť message; jej obsah možno prečítať cez event.data.
postMessage() zaradí doručenie do frontu namiesto toho, aby príjemcu zavolalo synchrónne. Údaje prechádzajú štruktúrovaným klonovaním. Voliteľný zoznam transfer prenáša prenositeľné objekty namiesto ich kopírovania; preniesť možno aj samotný port. Objekt na strane odosielateľa potom prestane byť použiteľný.
Pri použití addEventListener("message", handler) zavolajte na prijímajúcom porte start(). Priradenie onmessage spustí prijímanie automaticky. DataCloneError označuje chybu serializácie alebo zoznamu prenosu; messageerror signalizuje neúspešnú deserializáciu u príjemcu. Po skončení komunikácie zatvorte porty pomocou close().
Príklad používa oba porty na jednej stránke. Ide o API prehliadača; prítomnosť Node 24 v repozitári nedokladá podporu v prehliadačoch.
Prí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ýsledok
sent received: 42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.