CKTIS / JavaScript
MessageChannel — komunikacja przez parę portów
MessageChannel tworzy dwa połączone porty do asynchronicznej, dwukierunkowej wymiany komunikatów. Poznaj odbieranie zdarzeń, uruchamianie kolejki, klonowanie danych oraz zamykanie portów.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
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() tworzy dwa połączone obiekty MessagePort, dostępne przez właściwości tylko do odczytu port1 i port2. Komunikat wysłany przez jeden port trafia do drugiego jako zdarzenie message; dane odczytuje się z event.data. Dostarczenie jest asynchroniczne i nie przerywa aktualnego zadania.
Przypisanie onmessage automatycznie uruchamia kolejkę odbiorczą portu. Przy addEventListener('message', handler) trzeba wywołać start() na porcie odbierającym. Przykład wypisuje najpierw sent, a potem received: hello; po odbiorze zamyka oba porty przez close().
postMessage() używa klonowania strukturalnego, a nie współdzielenia zwykłych obiektów. Dane niemożliwe do sklonowania powodują DataCloneError. Opcjonalna lista transferu przenosi obsługiwane obiekty zamiast je kopiować; sam MessagePort można przekazać innemu oknu lub workerowi.
To Web API standardu HTML, nie funkcja konkretnej edycji ECMAScript. Konstruktor jest udostępniany w kontekstach Window i Worker i obsługiwany przez współczesne silniki przeglądarek. Obecność Node 24 w repozytorium nie potwierdza wsparcia w przeglądarce docelowej.
Przykłady
(() => {
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');
})();Wynik
sent received: hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.