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.