Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Zdarzenia Worker: wiadomości i błędy

Worker.onmessage odbiera odpowiedzi workera, Worker.onerror sygnalizuje błędy workera, a Worker.onmessageerror dotyczy nieudanej deserializacji odebranej wiadomości. Te trzy procedury obsługi działają na obiekcie Worker po stronie kodu, który go utworzył.

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

worker.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror i Worker.onmessageerror oznaczają właściwości przypisywane na instancji, np. worker.onmessage. Obsługują odpowiednio zdarzenia message, error i messageerror po stronie twórcy dedykowanego workera. To interfejsy Web API określone w standardzie HTML, a nie funkcje konkretnej edycji ECMAScript.

Worker.onmessage otrzymuje MessageEvent; przesłana wartość znajduje się w event.data. Wywołanie worker.postMessage(value) wysyła dane do workera, a self.postMessage(value) wewnątrz workera wysyła odpowiedź. Z kolei Worker.onerror otrzymuje jeden argument zdarzenia zgłaszającego błąd workera. Nie należy mylić go z self.onerror wewnątrz workera, który ma historyczną sygnaturę wieloargumentową.

Worker.onmessageerror otrzymuje MessageEvent, gdy przychodzącej wiadomości nie można zdeserializować. Nie jest to ogólna obsługa błędów obliczeń ani zamiennik obsługi wyjątków po stronie wysyłającej. Dane przekazywane przez postMessage() muszą być obsługiwane przez algorytm klonowania strukturalnego. Zdarzenia message i messageerror nie propagują się w górę i nie można ich anulować.

Alternatywą są addEventListener("message", handler), addEventListener("error", handler) i addEventListener("messageerror", handler). MDN oznacza message i error jako szeroko dostępne, lecz messageerror jako mające ograniczoną dostępność; sprawdź docelowe przeglądarki. Obecność Node 24 w repozytorium nie potwierdza obsługi tych API w przeglądarce.

Przykłady

(() => {
  const source = 'self.onmessage = (event) => { self.postMessage(event.data * 2); };';
  const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
  let worker;
  const cleanup = () => {
    worker?.terminate();
    URL.revokeObjectURL(url);
  };

  try {
    worker = new Worker(url);
    worker.onmessage = (event) => {
      console.log(`result: ${event.data}`);
      cleanup();
    };
    worker.onerror = () => {
      console.error('worker error');
      cleanup();
    };
    worker.onmessageerror = () => {
      console.error('message deserialization error');
      cleanup();
    };
    worker.postMessage(21);
  } catch (error) {
    cleanup();
    throw error;
  }
})();

Wynik

result: 42

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

Źródła