Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri