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.