KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Worker.postMessage — gegevens naar een worker sturen

Worker.postMessage stuurt gegevens via een asynchroon berichtenkanaal naar een dedicated worker. De gegevens worden structureel gekloond; met een optionele transferlijst kun je bronnen zoals ArrayBuffer overdragen in plaats van ze te kopiëren.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

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

Worker.postMessage is een instantiemethode van Worker, geen statische methode van de constructor. Met worker.postMessage(message) stuur je gegevens naar een dedicated worker. Een geslaagde aanroep garandeert niet dat het bericht aankomt: de worker kan stoppen voordat het event wordt afgevuurd. Als de deserialisatie aan de kant van de ontvanger mislukt, krijgt de ontvanger een messageerror-event in plaats van een message-event. Krijgt de ontvanger een message-event, dan leest die de gegevens uit event.data. De methode retourneert undefined, geen Promise; terugkeren betekent niet dat de ontvanger klaar is met zijn werk.

Het bericht wordt structureel gekloond en niet via JSON geserialiseerd. Onder andere gewone objecten en arrays worden ondersteund; functies worden niet ondersteund en veroorzaken synchroon een DataCloneError. Ga er niet van uit dat prototypes van eigen klassen behouden blijven. De bezorging is asynchroon, maar de serialisatie vindt tijdens de aanroep plaats en kan werk voor de verzender betekenen.

Het optionele tweede argument is een transfer-lijst of een object { transfer }. Het overdragen van een ArrayBuffer ontkoppelt de buffer van de verzender: de byteLength wordt dan 0. De buffer moet ook bereikbaar zijn vanuit message, zodat de ontvanger erbij kan; de transferlijst voegt hem niet zelf aan de berichtgegevens toe. Draag de buffer van een getypeerde array over, niet de getypeerde array zelf als item in de transferlijst.

Verstuur een antwoord in de worker met self.postMessage(...) en ontvang het op het object worker. Dit is niet window.postMessage: er is geen argument targetOrigin. SharedWorker gebruikt worker.port.postMessage(...). Deze API is vastgelegd in de HTML Living Standard, niet in een ECMAScript-editie. De basismethode wordt ondersteund door moderne browser-engines; controleer de compatibiliteit van de gebruikte overdrachtsvorm afzonderlijk. Node 24 bevestigt niet dat deze browser-API beschikbaar is.

Voorbeelden

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

Resultaat

sender bytes: 0
sum: 42

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen