Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

messageerror — błąd deserializacji wiadomości workera

Zdarzenie messageerror na obiekcie Worker sygnalizuje, że odebranej wiadomości nie udało się zdeserializować. Odróżniaj je od błędu wysyłania w postMessage() i od zdarzenia error związanego z błędem workera.

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.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };

Zdarzenie messageerror (messageerror event) jest emitowane na obiekcie Worker, gdy wiadomości przychodzącej z workera nie da się zdeserializować, czyli odtworzyć jej wartości po stronie odbiorcy. Jest to element Web APIs, a nie funkcja przypisana do konkretnej edycji ECMAScript. Zdarzenie ma typ MessageEvent, nie bąbelkuje i nie można go anulować.

Zarejestruj obsługę przez worker.addEventListener("messageerror", handler) albo przypisz funkcję do worker.onmessageerror. Pierwsza forma pozwala dodać wielu słuchaczy; druga ustawia pojedynczą właściwość obsługi. Kierunek ma znaczenie: słuchacz na Worker obsługuje odbiór po stronie kodu tworzącego workera; wewnątrz dedykowanego workera użyj self.addEventListener("messageerror", handler) do obsługi odbioru od jego twórcy.

Nie utożsamiaj tego zdarzenia z każdym problemem komunikacji. Próba wysłania wartości, której nie da się sklonować, może spowodować synchroniczny wyjątek DataCloneError w postMessage() — obsłuż go przez try...catch u nadawcy. Zdarzenie error dotyczy błędu workera, a nie konkretnie deserializacji wiadomości. Sam messageerror nie jest też mechanizmem walidacji danych aplikacji; poprawnie odebraną wiadomość nadal trzeba sprawdzić.

Przykład celowo wysyła syntetyczny MessageEvent do zwykłego EventTarget, dzięki czemu deterministycznie pokazuje uruchomienie słuchacza i flagi zdarzenia bez plików workera. Nie wywołuje rzeczywistego błędu deserializacji ani nie potwierdza natywnej obsługi zdarzenia na Worker. MDN oznacza wariant Worker jako mający ograniczoną dostępność: sprawdź zgodność przeglądarek docelowych. Obecność Node 24 w repozytorium nie dowodzi obsługi tego API w przeglądarce.

Przykłady

(() => {
  const target = new EventTarget();
  target.addEventListener("messageerror", (event) => {
    console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
  });
  target.dispatchEvent(new MessageEvent("messageerror"));
})();

Wynik

messageerror: bubbles=false, cancelable=false

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

Źródła