Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

MessagePort — punkt końcowy kanału wiadomości

MessagePort to jeden z dwóch punktów końcowych dwukierunkowego kanału. Umożliwia asynchroniczne przesyłanie danych i obiektów transferowalnych między połączonymi fragmentami kodu.

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 { 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 jest interfejsem Web API określonym w HTML, a nie w ECMAScript. Nie tworzysz go przez new MessagePort(): new MessageChannel() udostępnia połączone port1 i port2. Wiadomość wysłana jednym portem dociera do drugiego jako zdarzenie message; dane odczytujesz przez event.data.

postMessage() kolejkuje dostarczenie, zamiast wywoływać odbiorcę synchronicznie. Dane podlegają klonowaniu strukturalnemu. Opcjonalna lista transfer przenosi obiekty transferowalne zamiast je kopiować; sam port również można przenieść. Obiekt po stronie nadawcy przestaje wtedy nadawać się do użycia.

Przy addEventListener("message", handler) wywołaj start() na porcie odbiorczym. Przypisanie onmessage uruchamia odbieranie automatycznie. DataCloneError oznacza błąd serializacji lub listy transferu; messageerror sygnalizuje nieudaną deserializację u odbiorcy. Po zakończeniu komunikacji zamknij porty przez close().

Przykład używa obu portów w jednej stronie. To przeglądarkowe API; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.

Przykłady

(() => {
  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");
})();

Wynik

sent
received: 42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła