Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLIFrameElement: contentWindow e l’evento load

HTMLIFrameElement rappresenta un frame incorporato. La proprietà contentWindow espone la finestra del frame, mentre load consente di reagire al termine del caricamento. L’accesso al documento dipende dalla stessa origine e load da solo non conferma che il recupero sia riuscito.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

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

HTMLIFrameElement è l’interfaccia DOM di un elemento iframe, non una funzionalità del linguaggio ECMAScript. «Iframe contentWindow and load» combina l’accesso alla finestra di un frame con la gestione del suo caricamento. È un’API del browser; la presenza di Node 24 non ne dimostra la disponibilità. L’interfaccia di base e contentWindow sono ampiamente supportati, ma la compatibilità delle proprietà aggiuntive va verificata separatamente.

La proprietà di sola lettura contentWindow espone la finestra del contesto incorporato tramite un WindowProxy. La policy della stessa origine limita l’accesso: leggere contentWindow.document è consentito per un frame della stessa origine, ma genera un’eccezione per un frame di origine diversa. Per comunicare tra origini diverse, usa postMessage e verifica nel ricevente i valori attesi di event.origin e event.source.

Registra load sul frame stesso prima di avviare il caricamento o aggiungerlo al documento. L’evento non risale la gerarchia e non può essere annullato. Non considerarlo una prova del buon esito del recupero: i frame attivano load anche quando il caricamento non riesce e non attivano un error corrispondente. L’opzione { once: true } gestisce solo il primo evento, non le navigazioni successive.

L’esempio assegna un documento fisso tramite srcdoc, ne legge il testo dopo load e rimuove il frame. Senza restrizioni sandbox, quel documento ha la stessa origine del genitore. srcdoc interpreta HTML: non passarvi dati non attendibili. La CSP o un requisito TrustedHTML possono bloccare l’esempio.

Esempi

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);

Risultato

Ready

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti