CKTIS / JavaScript
MessagePort — ein Endpunkt eines Nachrichtenkanals
MessagePort ist einer der beiden Endpunkte eines bidirektionalen Kanals. Er ermöglicht die asynchrone Übertragung von Daten und übertragbaren Objekten zwischen verbundenen Codeabschnitten.
Version: 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 ist eine Web-API-Schnittstelle, die in HTML und nicht in ECMAScript definiert ist. Sie wird nicht mit new MessagePort() erstellt: new MessageChannel() stellt die verbundenen Ports port1 und port2 bereit. Eine über einen Port gesendete Nachricht erreicht den anderen als message-Ereignis; die Nutzdaten lassen sich über event.data auslesen.
postMessage() stellt die Zustellung in eine Warteschlange, statt den Empfänger synchron aufzurufen. Die Daten werden strukturiert geklont. Eine optionale transfer-Liste überträgt übertragbare Objekte, statt sie zu kopieren; auch ein Port selbst kann übertragen werden. Das Objekt auf der Senderseite ist danach nicht mehr verwendbar.
Bei addEventListener("message", handler) muss start() am empfangenden Port aufgerufen werden. Durch das Zuweisen von onmessage beginnt der Empfang automatisch. DataCloneError weist auf einen Serialisierungsfehler oder einen Fehler in der Transferliste hin; messageerror signalisiert eine fehlgeschlagene Deserialisierung beim Empfänger. Schließe die Ports mit close(), wenn die Kommunikation beendet ist.
Das Beispiel verwendet beide Ports innerhalb einer Seite. Dies ist eine Browser-API; dass Node 24 in einem Repository vorhanden ist, belegt keine Browserunterstützung.
Beispiele
(() => {
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");
})();Ergebnis
sent received: 42
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.