Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DedicatedWorkerGlobalScope.postMessage() — wysyłanie wiadomości z workera

DedicatedWorkerGlobalScope.postMessage wysyła dane z dedykowanego workera do jego twórcy. Odbiorca odczytuje je z event.data. Metoda obsługuje klonowanie strukturalne oraz opcjonalne przenoszenie własności obiektów.

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

self.postMessage(message)
self.postMessage(message, transfer)
self.postMessage(message, { transfer })

DedicatedWorkerGlobalScope.postMessage to metoda Web API dostępna wewnątrz dedykowanego workera jako self.postMessage(). Wysyła wiadomość do jego twórcy; odbiorca obsługuje zdarzenie message na obiekcie Worker i odczytuje event.data. W przeciwnym kierunku działa Worker.postMessage().

Argument message zawiera jedną wartość; wiele danych można umieścić w obiekcie lub tablicy. Klonowanie strukturalne obsługuje również odwołania cykliczne. Opcjonalna tablica transfer, podana bezpośrednio lub jako { transfer }, przenosi własność obsługiwanych obiektów zamiast je kopiować. Nie można ich potem używać po stronie wysyłającej. Sama lista nie dołącza obiektów do wiadomości: muszą być w niej zawarte lub dostępne odbiorcy inną drogą.

Metoda zwraca undefined, a nie odpowiedź odbiorcy. To API przeglądarki, nie funkcja ECMAScript; MDN oznacza je jako szeroko dostępne. Przykład tworzy dedykowanego workera, wysyła 21 i wypisuje odpowiedź 42.

Przykłady

const source = `
self.onmessage = (event) => {
  self.postMessage(event.data * 2);
};
`;
const url = URL.createObjectURL(
  new Blob([source], { type: "text/javascript" })
);
const worker = new Worker(url);

worker.onmessage = (event) => {
  console.log(event.data);
  worker.terminate();
  URL.revokeObjectURL(url);
};
worker.onerror = () => {
  worker.terminate();
  URL.revokeObjectURL(url);
  console.error("Worker failed");
};
worker.postMessage(21);

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła