Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje