CKTIS / JavaScript
messageerror — chyba deserializácie správy workera
Udalosť messageerror na objekte Worker signalizuje, že prichádzajúcu správu nebolo možné deserializovať. Odlišujte ju od chyby pri odosielaní cez postMessage() a od udalosti error súvisiacej s chybou workera.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };Udalosť messageerror event sa vyvolá na objekte Worker, keď prichádzajúcu správu z workera nemožno deserializovať, teda obnoviť jej hodnotu na strane príjemcu. Patrí do Web APIs, nie ku konkrétnemu vydaniu ECMAScriptu. Udalosť je typu MessageEvent, neprebubláva a nemožno ju zrušiť.
Obslužnú funkciu zaregistrujte pomocou worker.addEventListener("messageerror", handler) alebo funkciu priraďte k worker.onmessageerror. Prvá forma umožňuje viacero poslucháčov; druhá nastaví jednu vlastnosť obsluhy. Dôležitý je smer: poslucháč na Worker spracúva prijímanie v kóde, ktorý worker vytvoril. V dedikovanom workerovi použite self.addEventListener("messageerror", handler) na spracovanie prijímania od jeho tvorcu.
Nezamieňajte si túto udalosť s každým problémom komunikácie. Pokus o odoslanie hodnoty, ktorú nemožno klonovať, môže v postMessage() synchrónne vyvolať DataCloneError — na strane odosielateľa ho zachyťte pomocou try...catch. Udalosť error sa týka chyby workera, nie konkrétne deserializácie správy. messageerror nie je ani mechanizmom na overovanie aplikačných údajov; aj správne prijatú správu treba skontrolovať.
Príklad zámerne vyvolá syntetický MessageEvent na obyčajnom EventTarget. Deterministicky tak ukazuje zavolanie poslucháča a príznaky udalosti bez súborov workera. Nespôsobuje skutočnú chybu deserializácie ani nepotvrdzuje natívnu podporu udalosti na Worker. MDN označuje variant Worker ako obmedzene dostupný: skontrolujte kompatibilitu cieľových prehliadačov. Prítomnosť Node 24 v repozitári nedokazuje podporu tohto API v prehliadačoch.
Príklady
(() => {
const target = new EventTarget();
target.addEventListener("messageerror", (event) => {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
});
target.dispatchEvent(new MessageEvent("messageerror"));
})();Výsledok
messageerror: bubbles=false, cancelable=false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.