CKTIS / JavaScript
Worker: obsluha udalostí `message`, `error` a `messageerror`
Rozlíš tri udalosti vyhradeného workera: prijatie správy, chybu workera a správu, ktorú príjemca nedokáže deserializovať.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 a worker.onmessageerror sú vlastnosti na obsluhu udalostí na inštancii vyhradeného Worker na strane, ktorá ju vytvorila. Definuje ich štandard HTML, nie ECMAScript 2024. Podpora závisí od prostredia, najmä pri messageerror. Obslužné funkcie nastav pred odoslaním prvej požiadavky.
onmessage dostane MessageEvent, keď sa správa od workera úspešne deserializuje. Prečítaj obsah z event.data a over, či má štruktúru, ktorú aplikácia očakáva: štruktúrované klonovanie nekontroluje protokol aplikácie. Vo workeri obsluhuje self.onmessage opačný smer, teda správy z kontextu, ktorý ho vytvoril.
onerror dostane jeden objekt udalosti. Nezachytená synchrónna výnimka nahlásená kontextu, ktorý workera vytvoril, vyvolá ErrorEvent; nespoliehaj sa, že event.error obsahuje pôvodnú výnimku. Zlyhanie načítania skriptu môže vyvolať obyčajný Event. Pri zrušiteľnej udalosti môže event.preventDefault() zastaviť ďalšie hlásenie, ale neobnoví vykonávanie prerušeného kódu. Vo workeri má self.onerror pre ErrorEvent historickú podobu s piatimi argumentmi a môže zastaviť hlásenie pomocou return true; pre worker.onerror to neplatí.
onmessageerror dostane nezrušiteľný MessageEvent namiesto udalosti message, keď príjemca nedokáže správu deserializovať. Dekódovaný obsah nie je k dispozícii. Ak však odošleš funkciu cez postMessage(), volanie synchrónne vyvolá DataCloneError na strane odosielateľa a nespôsobí messageerror u príjemcu.
Každá vlastnosť uchováva jednu obslužnú funkciu: nové priradenie ju nahradí a null ju odstráni. Samostatných poslucháčov zaregistruješ cez addEventListener() s názvom udalosti bez on. Keď workera už nepotrebuješ, zavolaj worker.terminate(); metóda nečaká na dokončenie rozpracovaných ani čakajúcich úloh.
Príklady
(() => {
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);
})();Výsledok
send: DataCloneError message: 42 messageerror (synthetic) error: runtime
Ak si chceš vyskúšať vlastnosti na obsluhu udalostí Web Workera, spusti celý príklad v konzole prehliadača na stránke, ktorej bezpečnostné pravidlá povoľujú workery s adresou `blob:`. Pre Node.js 24 ulož kód ako `main.cjs` a spusti `node main.cjs`; táto vetva používa `node:worker_threads`, nie vlastnosti na obsluhu udalostí prehliadačového `Worker`. V oboch prostrediach `messageerror (synthetic)` testuje len obslužnú funkciu, nie skutočné zlyhanie deserializácie ani natívnu podporu udalosti.
Súvisiace lekcie
- JavaScript · Lekcia 32 · Pokročilá · Verzia: 4
Zdroje
- HTML Standard — Dedicated workers and the Worker interface
- HTML Standard — The worker's lifetime
- HTML Standard — Runtime script errors
- HTML Standard — Event handlers
- HTML Standard — Message ports
- HTML Standard — StructuredSerializeInternal
- Worker: message event
- Worker: messageerror event
- Worker: Worker() constructor
- HTML Standard — Processing model