Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła