База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DedicatedWorkerGlobalScope.postMessage() — изпращане на съобщения от worker

DedicatedWorkerGlobalScope.postMessage изпраща данни от специализиран worker до неговия създател. Получателят ги прочита чрез event.data. Методът поддържа структурирано клониране и незадължително прехвърляне на собствеността върху обекти.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

DedicatedWorkerGlobalScope.postMessage е метод от Web API, достъпен в специализиран worker като self.postMessage(). Той изпраща съобщение до създателя на worker-а. Получателят обработва събитието message върху обекта Worker и прочита event.data. В обратната посока се използва Worker.postMessage().

Аргументът message съдържа една стойност; няколко елемента могат да се обединят в обект или масив. Структурираното клониране поддържа и циклични препратки. Незадължителният масив transfer, подаден директно или като { transfer }, прехвърля собствеността върху поддържаните обекти, вместо да ги копира. След това те вече не могат да се използват от страната на изпращача. Самият списък не добавя обекти към съобщението: те трябва да са включени в него или да са достъпни за получателя по друг начин.

Методът връща undefined, а не отговора на получателя. Това е API на браузъра, а не функция на ECMAScript; MDN го отбелязва като широко достъпно. Примерът създава специализиран worker, изпраща 21 и извежда отговора 42.

Примери

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);

Резултат

42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници