KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DedicatedWorkerGlobalScope.postMessage() — berichten versturen vanuit een worker

DedicatedWorkerGlobalScope.postMessage verstuurt gegevens vanuit een dedicated worker naar de maker ervan. De ontvanger leest ze via event.data. De methode ondersteunt gestructureerd klonen en optionele overdracht van eigenaarschap van objecten.

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

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

DedicatedWorkerGlobalScope.postMessage is een Web-API-methode die binnen een dedicated worker beschikbaar is als self.postMessage(). De methode verstuurt een bericht naar de maker van de worker. De ontvanger verwerkt het message-event op het Worker-object en leest event.data. Voor de omgekeerde richting gebruik je Worker.postMessage().

Het argument message bevat één waarde; bundel meerdere waarden in een object of array. Gestructureerd klonen ondersteunt ook cyclische verwijzingen. De optionele array transfer, rechtstreeks opgegeven of als { transfer }, draagt het eigenaarschap van ondersteunde objecten over in plaats van ze te kopiëren. Daarna kunnen ze aan de verzendende kant niet meer worden gebruikt. De lijst voegt op zichzelf geen objecten aan het bericht toe: ze moeten erin zijn opgenomen of op een andere manier toegankelijk zijn voor de ontvanger.

De methode retourneert undefined, niet het antwoord van de ontvanger. Dit is een browser-API, geen ECMAScript-functie; MDN vermeldt dat deze breed beschikbaar is. Het voorbeeld maakt een dedicated worker, verstuurt 21 en logt het antwoord 42.

Voorbeelden

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

Resultaat

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