CKTIS / JavaScript
Window.parent, Window.self и Window.origin
Разграничавайте препратките към текущия и родителския прозорец от произхода, представен като низ. Препратката към прозорец не осигурява достъп до документа му.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
window.parent
window.self
window.originwindow.self връща WindowProxy на текущия контекст на разглеждане; обикновено window.self === window. В рамка window.parent сочи към непосредствения родителски прозорец, не непременно към window.top. В активна страница от най-горно ниво сочи към самата страница. Гетърът на parent може да върне null, ако неговият Window вече не е свързан с активния документ на навигационен контекст.
В активна страница window.parent !== window.self установява дали тя е вградена, а не дали произходът е различен, при условие че вградените гетъри на parent и self не са засенчени. WindowProxy запазва идентичността си в същия контекст на разглеждане, дори когато навигацията смени Window, към който проксито препраща операциите.
window.origin връща произхода на глобалната среда като низ. При HTTP(S) схемата, хостът и портът определят произхода; портът по подразбиране се пропуска в низа. Непрозрачният произход се сериализира като "null", а не като стойността null. Два такива низа не доказват общ произход. location.origin описва произхода на URL адреса: началният документ about:blank в рамка без sandbox може да наследи произхода на родителската страница, въпреки че произходът на URL адреса му е "null".
Можете да получите window.parent и при различен произход, но четенето на window.parent.document или window.parent.origin тогава обикновено се блокира с изключение DOMException с име SecurityError. За обмен на съобщения използвайте postMessage с точен targetOrigin, когато произходът на получателя може да бъде указан. При получаване проверявайте event.origin, очаквания event.source и формата на данните. Не приемайте само "null" за доказателство за самоличността на подателя.
Това са интерфейси на уеб платформата, а не част от ECMAScript 2024. Web IDL отбелязва и трите свойства като readonly и [Replaceable]: присвояване от същия произход може да засенчи гетъра със собствено свойство, но не променя връзките между прозорците или произхода, използван при проверки за сигурност. В Web Worker self е WorkerGlobalScope, а self.origin описва произхода на worker-а; там няма Window.parent.
Примери
<!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>Резултат
{"self":true,"parent":true,"embedded":true,"inheritedOrigin":true,"urlOrigin":"null"}Отворете този HTML документ в браузър като HTTPS страница от най-горно ниво, без sandbox и без политика, блокираща вградения скрипт или празната рамка. Рамката наследява произхода на страницата, но произходът на URL адреса ѝ `about:blank` е `"null"`. Прочетете реда с JSON в конзолата на браузъра след събитието `load`.
Свързани уроци
- JavaScript · Урок 5 · Напреднало · Версия: 4
Източници
- 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