CKTIS / JavaScript
Dogodki Worker: sporočila in napake
Worker.onmessage prejema odgovore workerja, Worker.onerror sporoča napake workerja, Worker.onmessageerror pa obravnava neuspešno deserializacijo dohodnega sporočila. Ti trije obravnavalniki pripadajo objektu Worker v kodi, ki je workerja ustvarila.
Različica: 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 in Worker.onmessageerror označujejo lastnosti, ki jih nastavimo na primerku, na primer worker.onmessage. V kodi, ki je ustvarila namenskega workerja, obravnavajo dogodke message, error oziroma messageerror. To so spletni API-ji, določeni v standardu HTML, ne funkcije določene izdaje ECMAScript.
Worker.onmessage prejme MessageEvent; prenesena vrednost je v event.data. Klic worker.postMessage(value) pošlje podatke workerju, self.postMessage(value) znotraj workerja pa pošlje odgovor. Worker.onerror prejme en sam argument: dogodek, ki sporoča napako workerja. Ne zamenjujte ga z obravnavalnikom self.onerror znotraj workerja, ki ima iz zgodovinskih razlogov podpis z več argumenti.
Worker.onmessageerror prejme MessageEvent, kadar dohodnega sporočila ni mogoče deserializirati. Ne gre za splošni obravnavalnik napak pri izračunih ali nadomestilo za obravnavo izjem na strani pošiljatelja. Podatke, posredovane z postMessage(), mora podpirati algoritem strukturiranega kloniranja. Dogodka message in messageerror se ne širita navzgor in ju ni mogoče preklicati.
Uporabite lahko tudi addEventListener("message", handler), addEventListener("error", handler) in addEventListener("messageerror", handler). MDN označuje message in error kot široko podprta, messageerror pa kot omejeno podprt; preverite ciljne brskalnike. Prisotnost Node 24 v repozitoriju ne dokazuje podpore teh API-jev v brskalnikih.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.