CKTIS / JavaScript
MessagePort — een eindpunt van een berichtenkanaal
MessagePort is een van de twee eindpunten van een bidirectioneel kanaal. Het maakt asynchrone overdracht van gegevens en overdraagbare objecten mogelijk tussen verbonden stukken code.
Versie: 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 is een interface van de Web-API die is gedefinieerd door HTML, niet door ECMAScript. Je maakt deze niet aan met new MessagePort(): new MessageChannel() levert de verbonden poorten port1 en port2. Een bericht dat via de ene poort wordt verzonden, komt bij de andere aan als een message-gebeurtenis; de inhoud lees je via event.data.
postMessage() zet de bezorging in de wachtrij in plaats van de ontvanger synchroon aan te roepen. De gegevens worden gestructureerd gekloond. Met een optionele transfer-lijst worden overdraagbare objecten overgedragen in plaats van gekopieerd; ook een poort zelf kan worden overgedragen. Het object aan de verzendende kant is daarna niet meer bruikbaar.
Roep bij addEventListener("message", handler) start() aan op de ontvangende poort. Door onmessage toe te wijzen, begint de ontvangst automatisch. DataCloneError duidt op een serialisatie- of transferlijstfout; messageerror geeft aan dat deserialisatie bij de ontvanger is mislukt. Sluit de poorten met close() wanneer de communicatie is afgelopen.
Het voorbeeld gebruikt beide poorten binnen één pagina. Dit is een browser-API; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.
Voorbeelden
(() => {
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");
})();Resultaat
sent received: 42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.