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.