Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

iframe: la proprietà contentWindow e l’evento load

`contentWindow` restituisce un riferimento alla finestra dell’iframe. `load` indica che un tentativo di caricamento è terminato, ma non garantisce il successo né concede l’accesso al DOM.

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

Sintassi

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

iframe.contentWindow è una proprietà di sola lettura. Restituisce il WindowProxy del contesto di navigazione dell’iframe oppure null se il contesto non esiste, come in un iframe appena creato ma non ancora inserito. Nelle navigazioni all’interno dello stesso contesto il proxy mantiene la propria identità anche se cambiano gli oggetti Window e Document sottostanti. La presenza del proxy non indica che il documento desiderato sia pronto.

Registra il listener di load sull’elemento iframe, non sulla sua finestra, prima di inserirlo o di avviare la navigazione da osservare. Una navigazione successiva può generare di nuovo l’evento; con { once: true } il listener viene rimosso subito prima di essere chiamato per la prima volta. load può scattare anche se il caricamento non riesce, e l’elemento non segnala quel fallimento con error. Nessuno dei due eventi concede l’accesso o conferma che l’applicazione incorporata sia pronta.

Puoi leggere iframe.contentWindow.document se il documento dell’iframe e la pagina contenitore hanno la stessa origine. Se le origini sono diverse, la lettura genera SecurityError, mentre iframe.contentDocument restituisce null. Un sandbox senza allow-same-origin può assegnare al documento un’origine opaca. Per comunicare con un iframe cooperante di un’altra origine nota, usa postMessage() con un targetOrigin esatto; chi riceve il messaggio deve controllare event.origin, event.source e la struttura dei dati.

Queste sono API della piattaforma web, non funzionalità di ECMAScript 2024. L’esempio richiede un browser con un DOM; il supporto e le politiche di sicurezza dipendono dall’ambiente.

Esempi

<!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>

Risultato

true
Frame ready

Salva l’esempio come file HTML, servilo tramite HTTP(S) e aprilo in un browser. La pagina deve consentire lo script inline, l’iframe e l’assegnazione a `srcdoc`. Nella console del browser compare `true` prima dell’inserimento e `Frame ready` nel gestore di `load`. L’esempio usa una stringa `srcdoc` fissa e attendibile, non carica documenti esterni e rimuove l’iframe dopo averne letto il titolo.

Lezioni correlate

  • JavaScript · Lezione 5 · Avanzato · Versione: 4

Fonti