CKTIS / JavaScript
messageerror — napaka pri deserializaciji sporočila workerja
Dogodek messageerror na objektu Worker sporoča, da vhodnega sporočila ni bilo mogoče deserializirati. Razlikuj ga od napake pri pošiljanju prek postMessage() in od dogodka error, povezanega z napako workerja.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };Dogodek messageerror event se sproži na objektu Worker, kadar vhodnega sporočila iz workerja ni mogoče deserializirati, torej obnoviti njegove vrednosti na strani prejemnika. Spada med Web APIs, ne pa v določeno izdajo ECMAScript. Dogodek je vrste MessageEvent, ne mehurči in ga ni mogoče preklicati.
Obravnavo registriraj z worker.addEventListener("messageerror", handler) ali funkcijo priredi lastnosti worker.onmessageerror. Prva oblika omogoča več poslušalcev, druga pa nastavi eno samo lastnost za obravnavo. Smer je pomembna: poslušalec na Worker obravnava prejemanje v kodi, ki je worker ustvarila. Znotraj namenskega workerja uporabi self.addEventListener("messageerror", handler) za obravnavo prejemanja od njegovega ustvarjalca.
Tega dogodka ne zamenjuj z vsako težavo pri komunikaciji. Poskus pošiljanja vrednosti, ki je ni mogoče klonirati, lahko v postMessage() sinhrono sproži DataCloneError — pri pošiljatelju ga obravnavaj z try...catch. Dogodek error se nanaša na napako workerja, ne posebej na deserializacijo sporočila. messageerror tudi ni namenjen preverjanju podatkov aplikacije; pravilno prejeto sporočilo je treba še vedno preveriti.
Primer namerno sproži sintetični MessageEvent na navadnem EventTarget. Tako deterministično pokaže klic poslušalca in zastavice dogodka, ne da bi potreboval datoteke workerja. Ne povzroči resnične napake pri deserializaciji in ne dokazuje izvorne podpore dogodka na Worker. MDN označuje različico Worker kot omejeno dostopno: preveri združljivost ciljnih brskalnikov. Prisotnost Node 24 v repozitoriju ne dokazuje podpore tega API-ja v brskalniku.
Primeri
(() => {
const target = new EventTarget();
target.addEventListener("messageerror", (event) => {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
});
target.dispatchEvent(new MessageEvent("messageerror"));
})();Rezultat
messageerror: bubbles=false, cancelable=false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.