CKTIS / JavaScript
Worker: obravnava dogodkov `message`, `error` in `messageerror`
Razlikuj tri dogodke namenskega delavca: prejeto sporočilo, napako delavca in sporočilo, ki ga prejemnik ne more deserializirati.
Različica: 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 in worker.onmessageerror so lastnosti za obravnavo dogodkov na primerku namenskega Worker na strani, ki ga je ustvarila. Določa jih standard HTML, ne ECMAScript 2024. Podpora je odvisna od izvajalnega okolja, zlasti pri messageerror. Obravnavalnike nastavi pred pošiljanjem prve zahteve.
onmessage prejme MessageEvent, ko je sporočilo delavca uspešno deserializirano. Preberi vsebino iz event.data in preveri, ali ima obliko, ki jo pričakuje aplikacija: strukturirano kloniranje ne preverja pravil protokola. Znotraj delavca self.onmessage obravnava nasprotno smer, torej sporočila iz konteksta, ki ga je ustvaril.
onerror prejme en objekt dogodka. Neprestrežena sinhrona izjema, o kateri je obveščen kontekst, ki je ustvaril delavca, sproži ErrorEvent; ne računaj, da event.error vsebuje izvirno izjemo. Neuspešno nalaganje skripta lahko sproži navaden Event. Pri dogodku, ki ga je mogoče preklicati, lahko event.preventDefault() ustavi nadaljnje poročanje, ne nadaljuje pa prekinjene kode. Znotraj delavca ima self.onerror za ErrorEvent zgodovinsko obliko s petimi argumenti in lahko z return true ustavi poročanje; to pravilo ne velja za worker.onerror.
onmessageerror prejme MessageEvent, ki ga ni mogoče preklicati, namesto dogodka message, kadar prejemnik ne more deserializirati sporočila. Dekodirane vsebine ni na voljo. Če pa pošiljatelj funkcijo poda v postMessage(), klic na strani pošiljatelja sinhrono sproži DataCloneError, pri prejemniku pa ne sproži messageerror.
Vsaka lastnost hrani en obravnavalnik: nova prireditev ga zamenja, null pa ga odstrani. Za registracijo neodvisnih poslušalcev uporabi addEventListener() z imenom dogodka brez on. Ko delavca ne potrebuješ več, pokliči worker.terminate(); metoda ne čaka, da se nedokončano delo izteče.
Primeri
(() => {
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
Če želiš preizkusiti lastnosti za obravnavo dogodkov spletnega delavca, zaženi celoten primer v konzoli brskalnika na strani, katere varnostna politika dovoljuje delavce z naslovi `blob:`. Za Node.js 24 shrani kodo kot `main.cjs` in zaženi `node main.cjs`; ta veja uporablja `node:worker_threads` namesto lastnosti za obravnavo dogodkov brskalnikovega `Worker`. V obeh okoljih `messageerror (synthetic)` preizkusi samo obravnavalnik, ne dejanske napake pri deserializaciji ali vgrajene podpore dogodku.
Povezane lekcije
- JavaScript · Lekcija 32 · Napredna · Različica: 4
Viri
- 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