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.