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

CKTIS / JavaScript

Události Worker: zprávy a chyby

Worker.onmessage přijímá odpovědi workeru, Worker.onerror oznamuje selhání workeru a Worker.onmessageerror řeší neúspěšnou deserializaci příchozí zprávy. Tyto tři obslužné rutiny patří k objektu Worker v kódu, který worker vytvořil.

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.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror a Worker.onmessageerror označují vlastnosti přiřazené instanci, například worker.onmessage. Na straně, která vytvořila dedikovaný worker, obsluhují postupně události message, error a messageerror. Jde o webová API specifikovaná standardem HTML, nikoli o funkce konkrétní edice ECMAScriptu.

Worker.onmessage přijímá MessageEvent; předaná hodnota je v event.data. Volání worker.postMessage(value) odešle data do workeru, zatímco self.postMessage(value) uvnitř workeru odešle odpověď. Worker.onerror naproti tomu přijímá jeden argument události oznamující selhání workeru. Nepleťte si ho s self.onerror uvnitř workeru, který má historicky vícero argumentů.

Worker.onmessageerror přijímá MessageEvent, když příchozí zprávu nelze deserializovat. Nejde o obecnou obsluhu chyb výpočtu ani o náhradu za zpracování výjimek na straně odesílatele. Data předaná do postMessage() musí podporovat algoritmus strukturovaného klonování. Události message ani messageerror se nešíří vzhůru a nelze je zrušit.

Alternativami jsou addEventListener("message", handler), addEventListener("error", handler) a addEventListener("messageerror", handler). MDN označuje message a error za široce dostupné, ale messageerror za omezeně dostupné; ověřte cílové prohlížeče. Přítomnost Node 24 v repozitáři nedokládá podporu těchto API v prohlížečích.

Příklady

(() => {
  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;
  }
})();

Výsledek

result: 42

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