Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

MessageChannel — communiquer au moyen de ports associés

MessageChannel crée deux ports connectés pour échanger des messages de façon asynchrone et bidirectionnelle. Découvrez comment recevoir des événements, démarrer la distribution, cloner des données et fermer les ports.

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

Syntaxe

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() crée deux objets MessagePort connectés, accessibles par les propriétés en lecture seule port1 et port2. Un message envoyé par l’un des ports parvient à l’autre sous la forme d’un événement message ; ses données se lisent avec event.data. La distribution est asynchrone et n’interrompt pas la tâche en cours.

L’affectation de onmessage démarre automatiquement la file de réception du port. Avec addEventListener('message', handler), appelez start() sur le port qui reçoit. L’exemple affiche d’abord sent, puis received: hello ; après réception du message, il ferme les deux ports avec close().

postMessage() utilise le clonage structuré au lieu de partager des objets ordinaires. Des données impossibles à cloner provoquent DataCloneError. Une liste de transfert facultative transfère les objets pris en charge au lieu de les copier ; un MessagePort peut lui-même être transféré à une autre fenêtre ou à un worker.

Il s’agit d’une API Web définie par HTML, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. Le constructeur est exposé dans les contextes Window et Worker et pris en charge par les moteurs de navigateur actuels. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge dans le navigateur cible.

Exemples

(() => {
  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');
})();

Résultat

sent
received: hello

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources