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.