CKTIS / JavaScript
Události Worker: zprávy a chyby
Worker.onmessage přijímá odpovědi workeru, Worker.onerror oznamuje selhání workeru a Worker.onmessageerror řeší neúspěšnou deserializaci příchozí zprávy. Tyto tři obslužné rutiny patří k objektu Worker v kódu, který worker vytvořil.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
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 přiřazené instanci, například worker.onmessage. Na straně, která vytvořila dedikovaný worker, obsluhují postupně události message, error a messageerror. Jde o webová API specifikovaná standardem HTML, nikoli o funkce konkrétní edice ECMAScriptu.
Worker.onmessage přijímá MessageEvent; předaná hodnota je v event.data. Volání worker.postMessage(value) odešle data do workeru, zatímco self.postMessage(value) uvnitř workeru odešle odpověď. Worker.onerror naproti tomu přijímá jeden argument události oznamující selhání workeru. Nepleťte si ho s self.onerror uvnitř workeru, který má historicky vícero argumentů.
Worker.onmessageerror přijímá MessageEvent, když příchozí zprávu nelze deserializovat. Nejde o obecnou obsluhu chyb výpočtu ani o náhradu za zpracování výjimek na straně odesílatele. Data předaná do postMessage() musí podporovat algoritmus strukturovaného klonování. Události message ani messageerror se nešíří vzhůru a nelze je zrušit.
Alternativami jsou addEventListener("message", handler), addEventListener("error", handler) a addEventListener("messageerror", handler). MDN označuje message a error za široce dostupné, ale messageerror za omezeně dostupné; ověřte cílové prohlížeče. Přítomnost Node 24 v repozitáři nedokládá podporu těchto API v prohlížečích.
Pří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ýsledek
result: 42
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.