CKTIS / JavaScript
MessagePort — končna točka sporočilnega kanala
MessagePort je ena od dveh končnih točk dvosmernega kanala. Omogoča asinhroni prenos podatkov in prenosljivih objektov med povezanimi deli kode.
Različica: 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 vmesnik spletnega API-ja, določen v HTML, ne v ECMAScriptu. Ne ustvarite ga z new MessagePort(): new MessageChannel() zagotovi povezana porta port1 in port2. Sporočilo, poslano prek enega porta, prispe na drugega kot dogodek message; njegovo vsebino preberete prek event.data.
postMessage() dostavo uvrsti v čakalno vrsto, namesto da bi prejemnika poklical sinhrono. Podatki se strukturno klonirajo. Izbirni seznam transfer prenese prenosljive objekte, namesto da bi jih kopiral; prenesti je mogoče tudi sam port. Objekt na strani pošiljatelja nato ni več uporaben.
Pri uporabi addEventListener("message", handler) pokličite start() na sprejemnem portu. Z dodelitvijo onmessage se sprejem začne samodejno. DataCloneError označuje napako pri serializaciji ali seznamu za prenos; messageerror sporoča neuspešno deserializacijo pri prejemniku. Ko je komunikacija končana, porta zaprite z close().
Primer uporablja oba porta na eni strani. To je API brskalnika; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.