CKTIS / JavaScript
Window.parent, Window.self et Window.origin
Distinguez les références à la fenêtre courante et à sa parente de l’origine sérialisée. Une référence à une fenêtre ne suffit pas pour accéder à son document.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
window.parent
window.self
window.originwindow.self renvoie le WindowProxy du contexte de navigation courant ; normalement, window.self === window. Dans un cadre, window.parent désigne le parent direct, pas nécessairement window.top. Dans une page active de premier niveau, il désigne cette page elle-même. L’accesseur parent peut renvoyer null si son Window n’est plus associé au document actif d’un contexte navigable.
Dans une page active, window.parent !== window.self détecte l’intégration dans un cadre, pas une différence d’origine, à condition que les accesseurs natifs de parent et de self ne soient pas masqués. Un WindowProxy conserve son identité dans le même contexte de navigation, même si une navigation change le Window auquel il transmet les opérations.
window.origin renvoie l’origine de l’environnement global sous forme de chaîne. Pour HTTP(S), le schéma, l’hôte et le port déterminent l’origine ; le port par défaut est omis de la chaîne. Une origine opaque donne "null", et non la valeur null. Deux chaînes de ce type ne prouvent pas une origine commune. location.origin décrit plutôt l’origine de l’URL : le document initial about:blank d’un cadre sans sandbox peut hériter de l’origine du parent, alors que l’origine de son URL vaut "null".
Il est possible d’obtenir window.parent même entre origines différentes, mais la lecture de window.parent.document ou de window.parent.origin est alors normalement bloquée par une DOMException nommée SecurityError. Pour communiquer, utilisez postMessage avec un targetOrigin exact lorsque l’origine du destinataire peut être précisée. À la réception, vérifiez event.origin, la valeur attendue de event.source et le format des données. Ne vous fiez pas à "null" seul pour identifier l’expéditeur.
Ces API relèvent de la plateforme web et non d’ECMAScript 2024. Web IDL marque les trois propriétés readonly et [Replaceable] : une affectation de même origine peut masquer l’accesseur par une propriété propre, sans modifier les relations entre fenêtres ni l’origine de sécurité. Dans un Web Worker, self désigne le WorkerGlobalScope et self.origin décrit le worker ; Window.parent n’y existe pas.
Exemples
<!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>Résultat
{"self":true,"parent":true,"embedded":true,"inheritedOrigin":true,"urlOrigin":"null"}Ouvrez ce document HTML dans un navigateur en tant que page HTTPS de premier niveau, sans sandbox ni règle bloquant le script intégré ou le cadre vide. Le cadre hérite de l’origine de la page, mais l’origine de son URL `about:blank` vaut `"null"`. Lisez la ligne JSON dans la console du navigateur après l’événement `load`.
Leçons associées
- JavaScript · Leçon 5 · Avancé · Version : 4
Sources
- 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