Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Događaji Worker: poruke i pogreške

Worker.onmessage prima odgovore workera, Worker.onerror prijavljuje pogreške workera, a Worker.onmessageerror obrađuje neuspjelu deserijalizaciju dolazne poruke. Ova tri rukovatelja pripadaju objektu Worker u kodu koji je stvorio worker.

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

Sintaksa

worker.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };

Worker.onmessage, Worker.onerror i Worker.onmessageerror označavaju svojstva dodijeljena instanci, primjerice worker.onmessage. Na strani koja je stvorila namjenski worker obrađuju redom događaje message, error i messageerror. To su web-API-ji definirani standardom HTML, a ne značajke određenog izdanja ECMAScripta.

Worker.onmessage prima MessageEvent; prenesena vrijednost nalazi se u event.data. Poziv worker.postMessage(value) šalje podatke workeru, dok self.postMessage(value) unutar workera šalje odgovor. Worker.onerror prima jedan argument događaja koji prijavljuje pogrešku workera. Nemojte ga zamijeniti sa self.onerror unutar workera, koji ima povijesni potpis s više argumenata.

Worker.onmessageerror prima MessageEvent kada se dolazna poruka ne može deserijalizirati. Nije riječ o općem rukovatelju pogreškama izračuna niti o zamjeni za obradu iznimki na strani pošiljatelja. Podatke proslijeđene u postMessage() mora podržavati algoritam strukturiranog kloniranja. Događaji message i messageerror ne šire se prema gore i ne mogu se otkazati.

Alternative su addEventListener("message", handler), addEventListener("error", handler) i addEventListener("messageerror", handler). MDN označava message i error kao široko dostupne, a messageerror kao ograničeno dostupan; provjerite ciljane preglednike. Prisutnost Node 24 u repozitoriju ne dokazuje podršku za te API-je u preglednicima.

Primjeri

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

Rezultat

result: 42

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori