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

CKTIS / JavaScript

Worker.postMessage — изпращане на данни към worker

Worker.postMessage изпраща данни към специализиран worker чрез асинхронен канал за съобщения. Данните се клонират структурно; незадължителен списък за прехвърляне позволява да прехвърляте ресурси като ArrayBuffer вместо да ги копирате.

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

Синтаксис

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

Worker.postMessage обозначава метод на екземпляр на Worker, а не статичен метод на конструктора. Извикването worker.postMessage(message) изпраща данни към специализиран worker. Успешното извикване не гарантира доставяне на съобщението: worker-ът може да спре, преди събитието да бъде задействано. Ако десериализацията при получателя е неуспешна, той получава събитие messageerror вместо message. Когато получи събитие message, получателят прочита данните от event.data. Методът връща undefined, а не Promise; връщането от извикването не означава, че получателят е приключил работата си.

Съобщението се клонира структурно, а не се сериализира чрез JSON. Поддържат се, наред с други стойности, обикновени обекти и масиви; функциите не се поддържат и предизвикват синхронно изключение DataCloneError. Не приемайте, че прототипите на потребителски класове ще бъдат запазени. Доставянето е асинхронно, но сериализацията се извършва по време на извикването и може да натовари изпращача.

Незадължителният втори аргумент е списък transfer или обект { transfer }. Прехвърлянето на ArrayBuffer отделя буфера на изпращача: неговият byteLength става 0. Буферът трябва също да е достъпен чрез message, за да може получателят да го използва; самият списък за прехвърляне не го добавя към данните на съобщението. Прехвърляйте буфера на типизиран масив, а не самия типизиран масив като елемент от списъка за прехвърляне.

Изпратете отговор вътре в worker чрез self.postMessage(...) и го получете върху обекта worker. Това не е window.postMessage: няма аргумент targetOrigin. SharedWorker използва worker.port.postMessage(...). Този API е дефиниран от HTML Living Standard, а не от издание на ECMAScript. Основният метод се поддържа от съвременните браузърни енджини; проверявайте отделно съвместимостта на използваната форма за прехвърляне. Node 24 не потвърждава наличието на този браузърен API.

Примери

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

Резултат

sender bytes: 0
sum: 42

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

Източници