CKTIS / JavaScript
Worker.postMessage — wysyłanie danych do workera
Worker.postMessage wysyła dane do dedykowanego workera przez asynchroniczny kanał wiadomości. Dane są klonowane strukturalnie, a opcjonalna lista transferu pozwala przekazać zasoby, takie jak ArrayBuffer, zamiast je kopiować.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
worker.postMessage(message)
worker.postMessage(message, transfer)
worker.postMessage(message, { transfer })Worker.postMessage oznacza metodę instancji Worker, nie metodę statyczną konstruktora. Wywołanie worker.postMessage(message) wysyła dane do dedykowanego workera. Wywołanie, które zakończyło się bez błędu, nie gwarantuje dostarczenia wiadomości: worker może zakończyć działanie, zanim zostanie wyemitowane zdarzenie. Jeśli deserializacja wiadomości po stronie odbiorcy się nie powiedzie, odbiorca otrzyma zdarzenie messageerror zamiast message. Po otrzymaniu zdarzenia message odbiorca odczytuje dane z event.data. Metoda zwraca undefined, nie Promise; zakończenie wywołania nie oznacza zakończenia pracy odbiorcy.
Wiadomość jest klonowana strukturalnie, a nie serializowana przez JSON. Można wysyłać m.in. zwykłe obiekty i tablice; funkcje nie są obsługiwane i powodują synchroniczny wyjątek DataCloneError. Nie należy zakładać zachowania prototypów własnych klas. Dostarczenie wiadomości jest asynchroniczne, ale serializacja odbywa się podczas wywołania i może obciążyć nadawcę.
Opcjonalny drugi argument to lista transfer albo obiekt { transfer }. Przekazanie ArrayBuffer odłącza bufor nadawcy: jego byteLength wynosi wtedy 0. Bufor musi też być osiągalny z message, jeśli odbiorca ma uzyskać do niego dostęp; sama lista transferu nie dodaje go do danych wiadomości. Przesyłaj bufor tablicy typowanej, nie samą tablicę jako element listy transferu.
Odpowiedź wysyła się wewnątrz workera przez self.postMessage(...), a odbiera na obiekcie worker. To nie jest window.postMessage: nie ma argumentu targetOrigin. SharedWorker używa worker.port.postMessage(...). API definiuje HTML Living Standard, nie edycja ECMAScript. Podstawowa metoda jest obsługiwana we współczesnych silnikach przeglądarek; zgodność używanego wariantu transferu sprawdzaj osobno. Node 24 nie potwierdza dostępności tego API przeglądarkowego.
Przykłady
const source = `
self.onmessage = ({ data }) => {
const values = new Uint8Array(data);
self.postMessage(values[0] + values[1]);
};
`;
const url = URL.createObjectURL(new Blob([source], {
type: 'text/javascript'
}));
const worker = new Worker(url);
const cleanup = () => {
worker.terminate();
URL.revokeObjectURL(url);
};
worker.onmessage = ({ data }) => {
console.log('sum:', data);
cleanup();
};
worker.onerror = () => {
console.error('Worker failed');
cleanup();
};
worker.onmessageerror = () => {
console.error('Message decoding failed');
cleanup();
};
const buffer = new Uint8Array([20, 22]).buffer;
worker.postMessage(buffer, [buffer]);
console.log('sender bytes:', buffer.byteLength);Wynik
sender bytes: 0 sum: 42
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.