CKTIS / JavaScript
Worker-gebeurtenissen: berichten en fouten
Worker.onmessage ontvangt antwoorden van de worker, Worker.onerror meldt fouten van de worker en Worker.onmessageerror verwerkt het mislukken van de deserialisatie van een binnenkomend bericht. Deze drie handlers horen bij het Worker-object in de code die de worker heeft gemaakt.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
worker.onmessage = (event) => { /* event.data */ };
worker.onerror = (event) => { /* worker failure */ };
worker.onmessageerror = (event) => { /* deserialization failure */ };Worker.onmessage, Worker.onerror en Worker.onmessageerror zijn eigenschappen die aan een instantie worden toegewezen, zoals worker.onmessage. Ze verwerken respectievelijk de gebeurtenissen message, error en messageerror aan de kant die een dedicated worker heeft gemaakt. Dit zijn Web-API’s die door HTML worden gespecificeerd, geen functies van een bepaalde ECMAScript-editie.
Worker.onmessage ontvangt een MessageEvent; de verzonden waarde staat in event.data. Met worker.postMessage(value) stuur je gegevens naar de worker, terwijl self.postMessage(value) binnen de worker een antwoord verstuurt. Worker.onerror ontvangt daarentegen één gebeurtenisargument dat een worker-fout meldt. Verwar dit niet met self.onerror binnen de worker, dat historisch een handtekening met meerdere argumenten heeft.
Worker.onmessageerror ontvangt een MessageEvent wanneer een binnenkomend bericht niet kan worden gedeserialiseerd. Het is geen algemene handler voor rekenfouten en geen vervanging voor het afhandelen van uitzonderingen aan de verzendende kant. Gegevens die aan postMessage() worden doorgegeven, moeten door het structured-clone-algoritme worden ondersteund. Noch message noch messageerror borrelt omhoog of kan worden geannuleerd.
Alternatieven zijn addEventListener("message", handler), addEventListener("error", handler) en addEventListener("messageerror", handler). MDN noemt message en error breed beschikbaar, maar messageerror beperkt beschikbaar; controleer de doelbrowsers. De aanwezigheid van Node 24 in een repository bewijst niet dat deze API’s door browsers worden ondersteund.
Voorbeelden
(() => {
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;
}
})();Resultaat
result: 42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.