CKTIS / JavaScript
MessageChannel — Kommunikation über gekoppelte Ports
MessageChannel erstellt zwei verbundene Ports für asynchrone Kommunikation in beide Richtungen. Erfahre, wie du Ereignisse empfängst, die Zustellung startest, Daten klonst und die Ports schließt.
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 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() erstellt zwei verbundene MessagePort-Objekte, die über die schreibgeschützten Eigenschaften port1 und port2 zugänglich sind. Eine über einen Port gesendete Nachricht erreicht den anderen als message-Ereignis; die Daten liest du mit event.data aus. Die Zustellung erfolgt asynchron und unterbricht nicht die aktuelle Aufgabe.
Wenn du onmessage zuweist, wird die Empfangswarteschlange des Ports automatisch gestartet. Bei addEventListener('message', handler) musst du start() am empfangenden Port aufrufen. Das Beispiel gibt zuerst sent und dann received: hello aus; nach dem Empfang schließt es beide Ports mit close().
postMessage() verwendet strukturiertes Klonen, statt gewöhnliche Objekte gemeinsam zu nutzen. Nicht klonierbare Daten lösen DataCloneError aus. Eine optionale Transferliste überträgt unterstützte Objekte, anstatt sie zu kopieren; ein MessagePort selbst kann an ein anderes Fenster oder einen Worker übertragen werden.
Dies ist eine durch HTML definierte Web API, keine Funktion einer bestimmten ECMAScript-Version. Der Konstruktor ist in Window- und Worker-Kontexten verfügbar und wird von aktuellen Browser-Engines unterstützt. Dass sich Node 24 in einem Repository befindet, belegt nicht die Unterstützung im Zielbrowser.
Beispiele
(() => {
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');
})();Ergebnis
sent received: hello
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.