Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła