CKTIS / JavaScript
messageerror — грешка при десериализация на съобщение от Worker
Събитието messageerror върху Worker показва, че входящо съобщение не е могло да бъде десериализирано. Разграничавайте го от грешка при изпращане чрез postMessage() и от събитието error, свързано с грешка на worker.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
worker.addEventListener("messageerror", (event) => { /* handle receive failure */ });
worker.onmessageerror = (event) => { /* handle receive failure */ };Събитието messageerror event се задейства върху обект Worker, когато входящо съобщение от worker не може да бъде десериализирано, тоест стойността му не може да бъде възстановена от страната на получателя. То принадлежи към Web APIs, а не към конкретно издание на ECMAScript. Събитието е от тип MessageEvent, не се разпространява нагоре по дървото и не може да бъде отменено.
Регистрирайте обработчик с worker.addEventListener("messageerror", handler) или задайте функция на worker.onmessageerror. Първият вариант позволява няколко слушателя, а вторият задава едно свойство за обработчик. Посоката е важна: слушател върху Worker обработва получаването в кода, създал worker. Вътре в специализиран worker използвайте self.addEventListener("messageerror", handler), за да обработвате получаването от неговия създател.
Не бъркайте това събитие с всеки проблем при комуникацията. Опитът за изпращане на стойност, която не може да бъде клонирана, може синхронно да предизвика DataCloneError в postMessage() — обработете го с try...catch при изпращача. Събитието error се отнася до грешка на worker, а не конкретно до десериализация на съобщение. messageerror не е и механизъм за проверка на данните на приложението; дори успешно полученото съобщение трябва да бъде проверено.
Примерът умишлено изпраща синтетичен MessageEvent към обикновен EventTarget. Така детерминистично показва извикването на слушателя и флаговете на събитието, без файлове на worker. Не предизвиква реална грешка при десериализация и не доказва нативна поддръжка на събитието върху Worker. MDN отбелязва, че вариантът Worker е с ограничена наличност: проверете съвместимостта с целевите браузъри. Наличието на Node 24 в хранилище не доказва поддръжка на този API в браузърите.
Примери
(() => {
const target = new EventTarget();
target.addEventListener("messageerror", (event) => {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
});
target.dispatchEvent(new MessageEvent("messageerror"));
})();Резултат
messageerror: bubbles=false, cancelable=false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.