Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Window.parent, Window.self e Window.origin

Distingui i riferimenti alla finestra corrente e a quella genitore dall’origine serializzata. Un riferimento a una finestra non dà accesso al suo documento.

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

Sintassi

window.parent
window.self
window.origin

window.self restituisce il WindowProxy del contesto di navigazione corrente; di norma, window.self === window. In un frame, window.parent indica la finestra genitore immediata, non necessariamente window.top. In una pagina attiva di primo livello indica la pagina stessa. Il getter di parent può restituire null se il suo Window non è più associato al documento attivo di un contesto navigabile.

In una pagina attiva, window.parent !== window.self rileva l’incorporamento, non una differenza di origine, purché i getter nativi di parent e self non siano stati mascherati. Un WindowProxy conserva la propria identità nello stesso contesto di navigazione, anche quando la navigazione cambia il Window a cui inoltra le operazioni.

window.origin restituisce l’origine dell’ambiente globale come stringa. Per HTTP(S), schema, host e porta definiscono l’origine; la porta predefinita è omessa dalla stringa. Un’origine opaca è serializzata come "null", non come il valore null. Due stringhe così non dimostrano un’origine comune. location.origin descrive invece l’origine dell’URL: l’about:blank iniziale di un frame senza sandbox può ereditare l’origine del genitore, anche se l’origine del suo URL è "null".

Puoi ottenere window.parent anche tra origini diverse, ma la lettura di window.parent.document o window.parent.origin viene normalmente bloccata con una DOMException di nome SecurityError. Per scambiare messaggi, usa postMessage con un targetOrigin esatto quando si può indicare l’origine del destinatario. Alla ricezione, verifica event.origin, il valore atteso di event.source e il formato dei dati. Non fidarti del solo "null" per identificare il mittente.

Queste API fanno parte della piattaforma web, non di ECMAScript 2024. Web IDL contrassegna tutte e tre le proprietà come readonly e [Replaceable]: un’assegnazione dalla stessa origine può mascherare il getter con una proprietà propria, ma non cambia le relazioni tra finestre né l’origine di sicurezza. In un Web Worker, self è il WorkerGlobalScope e self.origin descrive il worker; lì non esiste Window.parent.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Window.parent, Window.self, and Window.origin</title>
</head>
<body>
  <script>
    (() => {
      const frame = document.createElement("iframe");
      frame.addEventListener("load", () => {
        const child = frame.contentWindow;
        console.log(JSON.stringify({
          self: child.self === child,
          parent: child.parent === window.self,
          embedded: child.parent !== child.self,
          inheritedOrigin: child.origin === window.origin,
          urlOrigin: child.location.origin
        }));
        frame.remove();
      }, { once: true });
      document.body.append(frame);
    })();
  </script>
</body>
</html>

Risultato

{"self":true,"parent":true,"embedded":true,"inheritedOrigin":true,"urlOrigin":"null"}

Apri questo documento HTML nel browser come pagina HTTPS di primo livello, senza sandbox né criteri che blocchino lo script inline o il frame vuoto. Il frame eredita l’origine della pagina, ma l’origine del suo URL `about:blank` è `"null"`. Leggi la riga JSON nella console del browser dopo l’evento `load`.

Lezioni correlate

  • JavaScript · Lezione 5 · Avanzato · Versione: 4

Fonti