CKTIS / JavaScript
Worker: obsługa `message`, `error` i `messageerror`
Rozróżnij trzy zdarzenia dedykowanego workera: poprawny odbiór wiadomości, błąd workera i nieudaną deserializację po stronie odbiorcy.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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 i worker.onmessageerror to właściwości obsługi zdarzeń na instancji dedykowanego Worker po stronie, która go utworzyła. Definiuje je standard HTML, a nie ECMAScript 2024. Obsługa zależy od środowiska, zwłaszcza w przypadku messageerror. Ustaw procedury przed wysłaniem pierwszego żądania.
onmessage otrzymuje MessageEvent po pomyślnej deserializacji wiadomości wysłanej przez workera. Odczytaj treść z event.data i sprawdź, czy ma format oczekiwany przez aplikację: klonowanie strukturalne nie sprawdza zgodności z protokołem. Wewnątrz workera self.onmessage obsługuje przeciwny kierunek, czyli wiadomości od twórcy workera.
onerror otrzymuje jeden obiekt zdarzenia. Nieobsłużony wyjątek synchroniczny zgłoszony twórcy workera daje ErrorEvent; nie zakładaj, że event.error zawiera oryginalny wyjątek. Niepowodzenie ładowania skryptu może dać zwykły Event. Dla zdarzenia anulowalnego event.preventDefault() może zatrzymać dalsze raportowanie, ale nie wznawia przerwanego kodu. Wewnątrz workera self.onerror dla ErrorEvent przyjmuje historyczną postać z pięcioma argumentami i może anulować raportowanie przez return true; nie jest to reguła dla worker.onerror.
onmessageerror otrzymuje nieanulowalny MessageEvent zamiast message, gdy odbiorca nie może odtworzyć wiadomości. Nie ma wtedy zdekodowanej treści do odczytania. Jeśli natomiast nadawca przekaże funkcję do postMessage(), wywołanie zgłosi synchronicznie DataCloneError po stronie nadawcy i nie spowoduje zdarzenia messageerror u odbiorcy.
Każda właściwość przechowuje jedną procedurę: nowe przypisanie zastępuje poprzednią, a null ją usuwa. addEventListener() z nazwą bez on pozwala dodać niezależne procedury. Wywołaj worker.terminate(), gdy worker nie jest już potrzebny; metoda nie czeka na zakończenie oczekujących zadań.
Przykłady
(() => {
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);
})();Wynik
send: DataCloneError message: 42 messageerror (synthetic) error: runtime
Aby sprawdzić właściwości obsługi zdarzeń Web Workera, uruchom cały kod w konsoli przeglądarki na stronie, której polityka bezpieczeństwa zezwala na workery z adresów `blob:`. W Node.js 24 zapisz przykład jako `main.cjs` i uruchom `node main.cjs`; ta ścieżka używa `node:worker_threads`, a nie właściwości przeglądarkowego `Worker`. W obu środowiskach `messageerror (synthetic)` sprawdza wyłącznie procedurę obsługi, a nie rzeczywisty błąd deserializacji ani natywną obsługę zdarzenia.
Powiązane lekcje
- JavaScript · Lekcja 32 · Zaawansowany · Wersja: 4
Źródła
- 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