CKTIS / JavaScript
Window.parent, Window.self a Window.origin
Rozlišujte odkazy na aktuálne a nadradené okno od pôvodu zapísaného ako reťazec. Samotný odkaz na okno nezaručuje prístup k jeho dokumentu.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
window.parent
window.self
window.originwindow.self vracia WindowProxy aktuálneho kontextu prehliadania; bežne platí window.self === window. V rámci window.parent odkazuje na bezprostredne nadradené okno, nie nevyhnutne na window.top. Na aktívnej stránke najvyššej úrovne odkazuje na ňu samotnú. Getter parent môže vrátiť null, ak jeho Window už nie je priradené k aktívnemu dokumentu navigačného kontextu.
Na aktívnej stránke výraz window.parent !== window.self zisťuje vloženie do rámca, nie rozdielny pôvod, pokiaľ nie sú prekryté vstavané gettery vlastností parent a self. WindowProxy si zachováva identitu v tom istom kontexte prehliadania aj vtedy, keď navigácia zmení Window, ktorému odovzdáva operácie.
window.origin vracia pôvod globálneho prostredia ako reťazec. Pri HTTP(S) pôvod určuje schéma, hostiteľ a port; predvolený port sa v reťazci vynecháva. Nepriehľadný pôvod sa serializuje ako "null", nie ako hodnota null. Dva takéto reťazce nedokazujú spoločný pôvod. location.origin naopak opisuje pôvod adresy URL: počiatočné about:blank v rámci bez sandboxu môže zdediť pôvod nadradenej stránky, aj keď pôvod jeho URL je "null".
K window.parent sa dá pristúpiť aj pri odlišnom pôvode, ale čítanie window.parent.document alebo window.parent.origin sa vtedy zvyčajne zablokuje výnimkou DOMException s názvom SecurityError. Na odosielanie správ použite postMessage s presným targetOrigin, ak možno určiť pôvod príjemcu. Pri príjme kontrolujte event.origin, očakávanú hodnotu event.source a formát dát. Samotné "null" nepovažujte za dôkaz totožnosti odosielateľa.
Ide o rozhrania webovej platformy, nie o súčasť ECMAScriptu 2024. Web IDL označuje všetky tri vlastnosti ako readonly a [Replaceable]: priradenie z rovnakého pôvodu môže prekryť getter vlastnou vlastnosťou, ale nemení vzťahy medzi oknami ani bezpečnostný pôvod. Vo Web Workeri je self objekt WorkerGlobalScope a self.origin opisuje pôvod workera; Window.parent tam nie je.
Príklady
<!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>Výsledok
{"self":true,"parent":true,"embedded":true,"inheritedOrigin":true,"urlOrigin":"null"}Otvorte tento dokument HTML v prehliadači ako stránku HTTPS najvyššej úrovne bez sandboxu a bez pravidiel blokujúcich vložený skript alebo prázdny rámec. Rámec zdedí pôvod stránky, ale pôvod jeho URL `about:blank` je `"null"`. Riadok JSON sa v konzole prehliadača vypíše po udalosti `load`.
Súvisiace lekcie
- JavaScript · Lekcia 5 · Pokročilá · Verzia: 4
Zdroje
- 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