CKTIS / JavaScript
MessagePort — un point de terminaison d’un canal de communication
MessagePort est l’un des deux points de terminaison d’un canal bidirectionnel. Il permet la transmission asynchrone de données et d’objets transférables entre des parties de code connectées.
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 { port1, port2 } = new MessageChannel();
port1.postMessage(message);
port1.postMessage(message, transfer);
port1.postMessage(message, { transfer });
port2.addEventListener("message", handler);
port2.start();
port1.close();
port2.close();MessagePort est une interface de l’API Web définie par HTML, et non par ECMAScript. Elle ne se crée pas avec new MessagePort() : new MessageChannel() fournit les ports connectés port1 et port2. Un message envoyé par un port arrive sur l’autre sous la forme d’un événement message ; son contenu se lit avec event.data.
postMessage() met la livraison en file d’attente au lieu d’appeler le récepteur de façon synchrone. Les données sont soumises au clonage structuré. Une liste transfer facultative transfère les objets transférables au lieu de les copier ; un port peut lui aussi être transféré. L’objet du côté émetteur devient alors inutilisable.
Avec addEventListener("message", handler), appelez start() sur le port récepteur. L’affectation de onmessage démarre automatiquement la réception. DataCloneError indique une erreur de sérialisation ou de liste de transfert ; messageerror signale un échec de désérialisation chez le récepteur. Une fois la communication terminée, fermez les ports avec close().
L’exemple utilise les deux ports dans une même page. Il s’agit d’une API de navigateur ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge dans un navigateur.
Exemples
(() => {
const { port1, port2 } = new MessageChannel();
port2.addEventListener("message", (event) => {
console.log(`received: ${event.data.value}`);
port1.close();
port2.close();
}, { once: true });
port2.start();
port1.postMessage({ value: 42 });
console.log("sent");
})();Résultat
sent received: 42
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.