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

CKTIS / JavaScript

HTMLIFrameElement : contentWindow et l’événement load

HTMLIFrameElement représente une frame intégrée. Sa propriété contentWindow expose la fenêtre de la frame, tandis que load permet de réagir à la fin du chargement. L’accès au document dépend de la politique de même origine, et load seul ne confirme pas la réussite de la récupération.

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

iframe.contentWindow
iframe.addEventListener("load", handler);
iframe.srcdoc = trustedMarkup;

HTMLIFrameElement est l’interface DOM d’un élément iframe, et non une fonctionnalité du langage ECMAScript. « Iframe contentWindow and load » associe l’accès à la fenêtre d’une frame à la gestion de son chargement. Il s’agit d’une API de navigateur ; la présence de Node 24 ne prouve pas sa disponibilité. L’interface de base et contentWindow sont largement pris en charge, mais la compatibilité des propriétés supplémentaires doit être vérifiée séparément.

La propriété en lecture seule contentWindow expose la fenêtre du contexte intégré au moyen d’un WindowProxy. La politique de même origine restreint l’accès : la lecture de contentWindow.document est autorisée pour une frame de même origine, mais déclenche une exception pour une frame d’origine différente. Pour communiquer entre origines, utilise postMessage et vérifie, côté réception, les valeurs attendues de event.origin et event.source.

Enregistre load sur la frame elle-même avant de commencer le chargement ou de l’ajouter au document. L’événement ne remonte pas dans l’arborescence et ne peut pas être annulé. Ne le considère pas comme la preuve d’une récupération réussie : les frames déclenchent load même si le chargement échoue et ne déclenchent pas d’événement error correspondant. L’option { once: true } ne traite que le premier événement, pas les navigations suivantes.

L’exemple affecte un document fixe via srcdoc, lit son texte après load, puis supprime la frame. En l’absence de restrictions sandbox, ce document est de même origine que son parent. srcdoc interprète du HTML : n’y transmets pas de données non fiables. La CSP ou une exigence TrustedHTML peut bloquer l’exemple.

Exemples

const iframe = document.createElement("iframe");
iframe.title = "Demo";
iframe.addEventListener("load", () => {
  const childWindow = iframe.contentWindow;
  console.log(childWindow.document.querySelector("p").textContent);
  iframe.remove();
}, { once: true });
iframe.srcdoc = '<!doctype html><html lang="en"><title>Demo</title><body><p>Ready</p></body></html>';
document.body.append(iframe);

Résultat

Ready

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