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