База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Събития на Worker: съобщения и грешки

Worker.onmessage получава отговорите на worker-а, Worker.onerror съобщава за грешки на worker-а, а Worker.onmessageerror обработва неуспешното десериализиране на входящо съобщение. Тези три обработчика принадлежат на обекта Worker в кода, създал 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.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror и Worker.onmessageerror са свойства, зададени на екземпляр, например worker.onmessage. Те обработват съответно събитията message, error и messageerror от страната, създала dedicated worker. Това са уеб API, специфицирани от HTML, а не функции на конкретно издание на ECMAScript.

Worker.onmessage получава MessageEvent; предадената стойност е в event.data. Извикването на worker.postMessage(value) изпраща данни към worker-а, докато self.postMessage(value) вътре в worker-а изпраща отговор. За разлика от тях, Worker.onerror получава един аргумент-събитие, който съобщава за грешка на worker-а. Не го бъркайте с self.onerror вътре в worker-а, който има исторически подпис с няколко аргумента.

Worker.onmessageerror получава MessageEvent, когато входящо съобщение не може да бъде десериализирано. Това не е общ обработчик за грешки при изчисления и не замества обработката на изключения от страната на изпращача. Данните, подадени на postMessage(), трябва да се поддържат от алгоритъма за структурирано клониране. Нито message, нито messageerror се разпространява нагоре или може да бъде отменено.

Алтернативите са addEventListener("message", handler), addEventListener("error", handler) и addEventListener("messageerror", handler). MDN отбелязва message и error като широко достъпни, а messageerror като ограничено достъпно; проверете целевите браузъри. Наличието на Node 24 в хранилище не доказва поддръжка на тези API в браузърите.

Примери

(() => {
  const source = 'self.onmessage = (event) => { self.postMessage(event.data * 2); };';
  const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
  let worker;
  const cleanup = () => {
    worker?.terminate();
    URL.revokeObjectURL(url);
  };

  try {
    worker = new Worker(url);
    worker.onmessage = (event) => {
      console.log(`result: ${event.data}`);
      cleanup();
    };
    worker.onerror = () => {
      console.error('worker error');
      cleanup();
    };
    worker.onmessageerror = () => {
      console.error('message deserialization error');
      cleanup();
    };
    worker.postMessage(21);
  } catch (error) {
    cleanup();
    throw error;
  }
})();

Резултат

result: 42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници