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

CKTIS / JavaScript

window.postMessage — communication entre fenêtres

window.postMessage envoie des données de manière asynchrone à une fenêtre cible, y compris entre différentes origines. Indiquez de préférence un `targetOrigin` exact. Sans cette option, le message ne peut être remis qu’à une fenêtre de même origine. Le destinataire doit vérifier l’origine de l’expéditeur, la fenêtre émettrice et la structure des donné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

targetWindow.postMessage(message, targetOrigin[, transfer])
targetWindow.postMessage(message[, { targetOrigin, transfer }])

window.postMessage est une API de navigateur définie par le HTML Living Standard, et non une fonctionnalité d’une édition particulière d’ECMAScript. Les moteurs de navigateur actuels la prennent en charge ; la présence de Node 24 dans un dépôt ne prouve pas qu’elle y est disponible. Appelez la méthode sur la fenêtre destinataire, par exemple iframe.contentWindow ou une référence vers une fenêtre ouverte. L’envoi de messages ne donne pas accès au DOM d’une autre origine.

Le destinataire reçoit un événement message asynchrone : event.data contient les données, event.origin contient l’origine sérialisée de l’expéditeur au moment de l’envoi et event.source référence la fenêtre émettrice. Une origine représentée par un triplet est définie par le schéma, l’hôte et le port, pas par le chemin. Une origine opaque n’a pas de tel triplet et se sérialise en chaîne "null". Vérifier cette chaîne ne suffit pas à distinguer une origine opaque d’une autre. Enregistrez l’écouteur avant l’envoi ; pour une nouvelle frame, coordonnez-vous pour vous assurer que le destinataire est prêt.

Indiquez un targetOrigin exact. Si l’origine ne correspond pas à celle du destinataire, le message est ignoré. Dans la forme avec un objet d’options, omettre targetOrigin revient à utiliser "/", ce qui limite la réception à la même origine. "*" autorise toutes les origines — ne l’utilisez pas pour des données confidentielles. Les destinataires doivent vérifier event.origin, event.source et la structure des données ; ne traitez jamais les messages comme du code.

Les données sont sérialisées par l’algorithme de clonage structuré, et non en JSON. Les fonctions ne peuvent pas être clonées. La liste transfer déplace des ressources au lieu de les copier : un ArrayBuffer transféré est détaché du côté expéditeur. Des données non clonables ou des entrées en double dans la liste de transfert peuvent provoquer un DataCloneError. Dans l’exemple, une iframe isolée dans un bac à sable envoie un message à sa fenêtre parente avec window.parent.postMessage. La fenêtre parente vérifie que event.origin vaut "null" et que event.source désigne la fenêtre de l’iframe. Elle vérifie ensuite les données et affiche received: 42 dans la console.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Send a message from an iframe</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Message sender';
    frame.hidden = true;
    frame.setAttribute('sandbox', 'allow-scripts');

    // Use the page's exact origin when it has an HTTP(S) origin.
    // The wildcard fallback carries only the fixed, non-sensitive fixture.
    const targetOrigin = /^https?:\/\//.test(window.origin) ? window.origin : '*';

    function receive(event) {
      // The sandboxed sender has an opaque origin, serialized as "null".
      if (event.origin !== 'null' || event.source !== frame.contentWindow) return;
      const data = event.data;
      if (data === null || typeof data !== 'object' || Array.isArray(data)) return;
      if (data.type !== 'cktis-demo' || data.value !== 42) return;

      window.removeEventListener('message', receive);
      console.log(`received: ${data.value}`);
    }

    window.addEventListener('message', receive);
    frame.srcdoc = `<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Message sender</title></head>
<body>
  <script>
    window.parent.postMessage({ type: 'cktis-demo', value: 42 }, ${JSON.stringify(targetOrigin)});
  <\/script>
</body>
</html>`;
    document.body.append(frame);
  </script>
</body>
</html>

Résultat

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.

Sources