Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Udalosti Worker: správy a chyby

Worker.onmessage prijíma odpovede workera, Worker.onerror oznamuje zlyhania workera a Worker.onmessageerror rieši neúspešnú deserializáciu prichádzajúcej správy. Tieto tri obslužné funkcie patria k objektu Worker v kóde, ktorý worker vytvoril.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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 priradené inštancii, napríklad worker.onmessage. Na strane, ktorá vytvorila dedikovaný worker, obsluhujú postupne udalosti message, error a messageerror. Ide o webové API špecifikované štandardom HTML, nie o funkcie konkrétnej edície ECMAScriptu.

Worker.onmessage prijíma MessageEvent; prenesená hodnota je v event.data. Volanie worker.postMessage(value) odošle údaje do workera, zatiaľ čo self.postMessage(value) vo vnútri workera odošle odpoveď. Worker.onerror naproti tomu prijíma jeden argument udalosti oznamujúci zlyhanie workera. Nezamieňajte si ho s self.onerror vo vnútri workera, ktorý má historicky viacargumentovú signatúru.

Worker.onmessageerror prijíma MessageEvent, keď prichádzajúcu správu nemožno deserializovať. Nie je to všeobecná obsluha chýb výpočtu ani náhrada za spracovanie výnimiek na strane odosielateľa. Údaje odovzdané do postMessage() musí podporovať algoritmus štruktúrovaného klonovania. Udalosti message ani messageerror sa nešíria nahor a nemožno ich zrušiť.

Alternatívami sú addEventListener("message", handler), addEventListener("error", handler) a addEventListener("messageerror", handler). MDN označuje message a error za široko dostupné, ale messageerror za obmedzene dostupné; overte cieľové prehliadače. Prítomnosť Node 24 v repozitári nedokazuje podporu týchto API v prehliadačoch.

Prí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ýsledok

result: 42

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje