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

CKTIS / JavaScript

Worker: обработка на `message`, `error` и `messageerror`

Разграничи три събития при специализиран worker: получено съобщение, грешка в worker и съобщение, което получателят не може да десериализира.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const worker = new Worker(url);
worker.onmessage = (event) => { /* use event.data */ };
worker.onerror = (event) => { /* handle a worker error */ };
worker.onmessageerror = (event) => { /* handle a receive-side deserialization failure */ };

// Alternative for any of the three properties:
worker.addEventListener("message", handleMessage);
worker.addEventListener("error", handleError);
worker.addEventListener("messageerror", handleMessageError);

worker.onmessage, worker.onerror и worker.onmessageerror са свойства за обработка на събития на екземпляра на специализирания Worker от страната, която го е създала. Те се определят от стандарта HTML, а не от ECMAScript 2024. Поддръжката зависи от средата за изпълнение, особено за messageerror. Задай обработчиците преди изпращане на първата заявка.

onmessage получава MessageEvent, когато съобщение от worker е успешно десериализирано. Прочети съдържанието от event.data и провери дали структурата му отговаря на очакванията на приложението: структурираното клониране не проверява протокола ти. Вътре в worker self.onmessage обработва обратната посока, тоест съобщенията от контекста, който го е създал.

onerror получава един обект на събитие. Неуловено синхронно изключение, докладвано на създалия контекст, води до ErrorEvent; не разчитай, че event.error съдържа оригиналното изключение. Неуспешно зареждане на скрипта може да доведе до обикновен Event. Ако събитието може да бъде отменено, event.preventDefault() може да спре по-нататъшното докладване, но не възобновява прекъснатия код. Вътре в worker self.onerror има историческа форма с пет аргумента за ErrorEvent и може да спре докладването чрез return true; това правило не важи за worker.onerror.

onmessageerror получава MessageEvent, който не може да бъде отменен, вместо message, когато получателят не може да десериализира съобщението. Няма декодирано съдържание за прочитане. Ако обаче подадеш функция на postMessage(), извикването хвърля DataCloneError синхронно при изпращача и не предизвиква messageerror при получателя.

Всяко свойство съдържа един обработчик: ново присвояване го заменя, а null го премахва. За независими слушатели използвай addEventListener() с името на събитието без on. Извикай worker.terminate(), когато worker вече не ти е нужен; методът не изчаква незавършената работа.

Примери

(() => {
  const inNode = typeof require === "function" &&
    typeof process !== "undefined" && Boolean(process.versions?.node);

  const handler = `
    function handleMessage(data, reply) {
      if (data === "fail") throw new Error("demo failure");
      reply(data * 2);
    }
  `;

  let worker;
  let messageErrorTarget;

  function reportMessageError(event) {
    console.log(event.isTrusted ? "messageerror" : "messageerror (synthetic)");
  }

  function receiveReply(data) {
    console.log(`message: ${data}`);
    messageErrorTarget.dispatchEvent(new MessageEvent("messageerror"));
    worker.postMessage("fail");
  }

  if (inNode) {
    const { Worker: ThreadWorker } = require("node:worker_threads");
    worker = new ThreadWorker(handler + `
      const { parentPort } = require("node:worker_threads");
      parentPort.on("message", (data) => {
        handleMessage(data, (value) => parentPort.postMessage(value));
      });
    `, { eval: true });

    // Node worker threads do not use the browser's handler properties.
    messageErrorTarget = new EventTarget();
    messageErrorTarget.addEventListener("messageerror", reportMessageError);
    worker.on("message", receiveReply);
    worker.on("error", (error) => {
      if (error.message !== "demo failure") throw error;
      console.log("error: runtime");
    });
  } else {
    const script = handler + `
      self.onmessage = ({ data }) => {
        handleMessage(data, (value) => self.postMessage(value));
      };
    `;
    const url = URL.createObjectURL(new Blob([script], { type: "text/javascript" }));
    try {
      worker = new Worker(url);
    } catch (error) {
      URL.revokeObjectURL(url);
      throw error;
    }

    messageErrorTarget = worker;
    worker.onmessage = (event) => receiveReply(event.data);
    worker.onmessageerror = reportMessageError;
    worker.onerror = (event) => {
      event.preventDefault();
      console.log(event instanceof ErrorEvent ? "error: runtime" : "error: startup");
      worker.terminate();
      URL.revokeObjectURL(url);
    };
  }

  try {
    worker.postMessage(() => {});
  } catch (error) {
    console.log(`send: ${error.name}`);
  }
  worker.postMessage(21);
})();

Резултат

send: DataCloneError
message: 42
messageerror (synthetic)
error: runtime

За да изпробваш свойствата за обработка на събития на Web Worker, изпълни целия пример в конзолата на браузъра на страница, чиято политика за сигурност разрешава worker с адрес `blob:`. За Node.js 24 запази кода като `main.cjs` и изпълни `node main.cjs`; този клон използва `node:worker_threads`, а не свойствата за обработка на събития на `Worker` в браузъра. И в двете среди `messageerror (synthetic)` проверява само обработчика, а не действителна грешка при десериализация или вградената поддръжка на събитието.

Свързани уроци

  • JavaScript · Урок 32 · Напреднало · Версия: 4

Източници