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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.