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.originwindow.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
- HTML Living Standard — The Window object
- HTML Living Standard — Accessing related windows
- HTML Living Standard — The WindowProxy exotic object
- HTML Living Standard — The WindowOrWorkerGlobalScope mixin
- HTML Living Standard — Origins
- HTML Living Standard — The WorkerGlobalScope common interface
- HTML Living Standard — Cross-document messaging
- HTML Living Standard — Security infrastructure for Window, WindowProxy, and Location objects
- HTML Living Standard — The Location interface