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

CKTIS / JavaScript

iframe : la propriété contentWindow et l’événement load

`contentWindow` donne une référence à la fenêtre de l’iframe. `load` signale la fin d’une tentative de chargement, sans en confirmer le succès ni donner accès au DOM.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const frameWindow = iframe.contentWindow;
iframe.addEventListener("load", handler);
iframe.addEventListener("load", handler, { once: true });

iframe.contentWindow est une propriété en lecture seule. Elle renvoie le WindowProxy du contexte de navigation de l’iframe, ou null si ce contexte n’existe pas, par exemple avant l’insertion d’un nouvel iframe dans le document. Au fil des navigations dans le même contexte, le proxy garde son identité même si les objets Window et Document sous-jacents changent. Sa présence ne signifie pas que le document voulu est prêt.

Ajoutez l’écouteur de load à l’élément iframe, et non à sa fenêtre, avant d’insérer l’élément ou de lancer la navigation à observer. Une navigation ultérieure peut déclencher à nouveau l’événement ; avec { once: true }, l’écouteur est retiré juste avant son premier appel. load peut aussi se produire en cas d’échec du chargement, et l’élément ne signale pas cet échec par error. Aucun de ces événements ne donne de droit d’accès ni ne confirme que l’application intégrée est prête.

Vous pouvez lire iframe.contentWindow.document si le document de l’iframe et la page parente ont la même origine. Si leurs origines diffèrent, l’accès lève SecurityError, tandis que iframe.contentDocument renvoie null. Un sandbox sans allow-same-origin peut donner au document une origine opaque. Pour communiquer avec un iframe coopérant d’une autre origine connue, utilisez postMessage() avec un targetOrigin exact ; à la réception, vérifiez event.origin, event.source et la structure des données du message.

Il s’agit d’API de la plateforme web, et non de fonctionnalités d’ECMAScript 2024. L’exemple nécessite un navigateur doté d’un DOM ; la prise en charge et les politiques de sécurité dépendent de l’environnement.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>iframe contentWindow and load</title>
</head>
<body>
  <script>
    (() => {
      const iframe = document.createElement("iframe");
      console.log(iframe.contentWindow === null);

      iframe.srcdoc = "<!doctype html><title>Frame ready</title>";
      iframe.addEventListener("load", () => {
        console.log(iframe.contentWindow.document.title);
        iframe.remove();
      }, { once: true });

      document.body.append(iframe);
    })();
  </script>
</body>
</html>

Résultat

true
Frame ready

Enregistrez l’exemple dans un fichier HTML, servez-le via HTTP(S) et ouvrez-le dans un navigateur. La page doit autoriser le script intégré, l’iframe et l’affectation à `srcdoc`. La console du navigateur affiche `true` avant l’insertion puis `Frame ready` dans le gestionnaire de `load`. L’exemple utilise une chaîne `srcdoc` fixe et de confiance, ne charge aucun document externe et retire l’iframe après avoir lu son titre.

Leçons associées

  • JavaScript · Leçon 5 · Avancé · Version : 4

Sources