KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

MessageChannel — communicatie via gekoppelde poorten

MessageChannel maakt twee verbonden poorten voor asynchrone communicatie in beide richtingen. Leer hoe je gebeurtenissen ontvangt, de bezorging start, gegevens kloont en de poorten sluit.

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

const channel = new MessageChannel();
channel.port2.onmessage = (event) => {
  /* event.data */
  channel.port1.close();
  channel.port2.close();
};
// With addEventListener('message', handler), call port.start().
channel.port1.postMessage(value);

new MessageChannel() maakt twee verbonden MessagePort-objecten, toegankelijk via de alleen-lezen eigenschappen port1 en port2. Een bericht dat via de ene poort wordt verzonden, bereikt de andere als een message-gebeurtenis; de gegevens lees je uit event.data. De bezorging is asynchroon en onderbreekt de huidige taak niet.

Door onmessage toe te wijzen, wordt de ontvangstwachtrij van de poort automatisch gestart. Gebruik je addEventListener('message', handler), roep dan start() aan op de ontvangende poort. Het voorbeeld logt eerst sent en daarna received: hello; na ontvangst sluit het beide poorten met close().

postMessage() gebruikt gestructureerd klonen in plaats van gewone objecten te delen. Gegevens die niet kunnen worden gekloond veroorzaken DataCloneError. Een optionele overdrachtslijst draagt ondersteunde objecten over in plaats van ze te kopiëren; een MessagePort zelf kan worden overgedragen aan een ander venster of een worker.

Dit is een Web API die is gedefinieerd door HTML, geen functie van een bepaalde ECMAScript-editie. De constructor is beschikbaar in Window- en Worker-contexten en wordt ondersteund door huidige browser-engines. Dat Node 24 in een repository aanwezig is, bewijst niet dat de doelbrowser dit ondersteunt.

Voorbeelden

(() => {
  const channel = new MessageChannel();

  channel.port2.addEventListener('message', (event) => {
    console.log(`received: ${event.data.text}`);
    channel.port1.close();
    channel.port2.close();
  }, { once: true });
  channel.port2.start();

  channel.port1.postMessage({ text: 'hello' });
  console.log('sent');
})();

Resultaat

sent
received: hello

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