Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

messageerror — chyba deserializace zprávy workeru

Událost messageerror na objektu Worker signalizuje, že příchozí zprávu nebylo možné deserializovat. Rozlišujte ji od chyby při odesílání pomocí postMessage() a od události error související s chybou workeru.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };

Událost messageerror event se vyvolá na objektu Worker, když příchozí zprávu z workeru nelze deserializovat, tedy obnovit její hodnotu na straně příjemce. Patří do Web APIs, nikoli ke konkrétní edici ECMAScriptu. Událost je typu MessageEvent, neprobublává a nelze ji zrušit.

Obslužnou funkci zaregistrujte pomocí worker.addEventListener("messageerror", handler) nebo funkci přiřaďte k worker.onmessageerror. První možnost dovoluje více posluchačů; druhá nastaví jedinou vlastnost obsluhy. Záleží na směru: posluchač na Worker zpracovává příjem v kódu, který worker vytvořil. Uvnitř dedikovaného workeru použijte self.addEventListener("messageerror", handler) pro zpracování příjmu od jeho tvůrce.

Nezaměňujte tuto událost za každý problém s komunikací. Pokus o odeslání hodnoty, kterou nelze klonovat, může v postMessage() synchronně vyvolat DataCloneError — na straně odesílatele jej zachyťte pomocí try...catch. Událost error se týká chyby workeru, nikoli konkrétně deserializace zprávy. messageerror také neslouží k ověřování aplikačních dat; i správně přijatou zprávu je třeba zkontrolovat.

Příklad záměrně vyvolá syntetický MessageEvent na běžném objektu EventTarget. Deterministicky tak ukazuje zavolání posluchače a příznaky události, aniž by potřeboval soubory workeru. Nezpůsobuje skutečnou chybu deserializace ani nedokládá nativní podporu události na Worker. MDN označuje variantu Worker jako omezeně dostupnou: ověřte kompatibilitu cílových prohlížečů. Přítomnost Node 24 v repozitáři nedokazuje podporu tohoto API v prohlížečích.

Pří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ýsledek

messageerror: bubbles=false, cancelable=false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje