Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Worker: obrada događaja `message`, `error` i `messageerror`

Razlikuj tri događaja namjenskog workera: primljenu poruku, pogrešku workera i poruku koju primatelj ne može deserijalizirati.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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 i worker.onmessageerror svojstva su za obradu događaja na instanci namjenskog Worker na strani koja ju je stvorila. Definira ih standard HTML, a ne ECMAScript 2024. Podrška ovisi o izvršnom okruženju, osobito za messageerror. Postavi rukovatelje prije slanja prvog zahtjeva.

onmessage prima MessageEvent kada se poruka workera uspješno deserijalizira. Pročitaj sadržaj iz event.data i provjeri ima li strukturu koju aplikacija očekuje: strukturirano kloniranje ne provjerava tvoj protokol. Unutar workera self.onmessage obrađuje suprotan smjer, odnosno poruke iz konteksta koji ga je stvorio.

onerror prima jedan objekt događaja. Neuhvaćena sinkrona iznimka prijavljena kontekstu koji je stvorio worker daje ErrorEvent; ne oslanjaj se na to da event.error sadrži izvornu iznimku. Neuspjelo učitavanje skripte može dati običan Event. Ako se događaj može otkazati, event.preventDefault() može zaustaviti daljnju prijavu pogreške, ali ne nastavlja prekinuti kôd. Unutar workera self.onerror za ErrorEvent ima povijesni oblik s pet argumenata i može zaustaviti prijavu pomoću return true; to pravilo ne vrijedi za worker.onerror.

onmessageerror prima MessageEvent koji nije moguće otkazati umjesto događaja message kada primatelj ne može deserijalizirati poruku. Nema dekodiranog sadržaja za čitanje. Nasuprot tomu, prosljeđivanje funkcije u postMessage() sinkrono baca DataCloneError na strani pošiljatelja i ne uzrokuje messageerror kod primatelja.

Svako svojstvo sadrži jedan rukovatelj: nova ga dodjela zamjenjuje, a null ga uklanja. Za registraciju neovisnih slušatelja upotrijebi addEventListener() s nazivom događaja bez on. Pozovi worker.terminate() kada ti worker više ne treba; metoda ne čeka završetak nedovršenog posla.

Primjeri

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

Rezultat

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

Da isprobaš svojstva za obradu događaja Web Workera, pokreni cijeli primjer u konzoli preglednika na stranici čija sigurnosna pravila dopuštaju workere s adresom `blob:`. Za Node.js 24 spremi kôd kao `main.cjs` i pokreni `node main.cjs`; ta grana koristi `node:worker_threads`, a ne svojstva za obradu događaja koja nudi `Worker` u pregledniku. U oba okruženja `messageerror (synthetic)` provjerava samo rukovatelj, ne stvarni neuspjeh deserijalizacije ni ugrađenu podršku za događaj.

Povezane lekcije

  • JavaScript · Lekcija 32 · Napredno · Verzija: 4

Izvori