CKTIS / JavaScript
Window.parent, Window.self e Window.origin
Distingue as referências à janela atual e à janela ascendente da origem serializada. Ter uma referência a uma janela não dá acesso ao respetivo documento.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
window.parent
window.self
window.originwindow.self devolve o WindowProxy do contexto de navegação atual; normalmente, window.self === window. Num iframe, window.parent indica a janela imediatamente acima, não necessariamente window.top. Numa página ativa de nível superior aponta para a própria página. O getter de parent pode devolver null se o respetivo Window já não estiver associado ao documento ativo de um contexto navegável.
Numa página ativa, window.parent !== window.self deteta se a página está incorporada, não se as origens são diferentes, desde que os getters nativos de parent e self não tenham sido ocultados. Um WindowProxy mantém a sua identidade no mesmo contexto de navegação mesmo quando uma navegação muda o Window para o qual encaminha as operações.
window.origin devolve a origem do ambiente global como uma cadeia de caracteres. Em HTTP(S), o esquema, o anfitrião e a porta definem a origem; a porta predefinida é omitida da cadeia. Uma origem opaca é serializada como "null", não como o valor null. Duas cadeias dessas não demonstram uma origem comum. Já location.origin descreve a origem do URL: o about:blank inicial de um iframe sem sandbox pode herdar a origem da página ascendente, embora a origem do seu URL seja "null".
Podes obter window.parent mesmo entre origens diferentes, mas a leitura de window.parent.document ou window.parent.origin é nesses casos normalmente bloqueada com uma DOMException chamada SecurityError. Para trocar mensagens, utiliza postMessage com um targetOrigin exato quando for possível indicar a origem do destinatário. Ao receber, verifica event.origin, o valor esperado de event.source e o formato dos dados. Não confies apenas em "null" para identificar o remetente.
Estas API pertencem à plataforma Web, não ao ECMAScript 2024. A Web IDL marca as três propriedades como readonly e [Replaceable]: uma atribuição com a mesma origem pode ocultar o getter com uma propriedade própria, mas não altera as relações entre janelas nem a origem de segurança. Num Web Worker, self é o WorkerGlobalScope e self.origin descreve o worker; não existe aí Window.parent.
Exemplos
<!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>Resultado
{"self":true,"parent":true,"embedded":true,"inheritedOrigin":true,"urlOrigin":"null"}Abre este documento HTML no navegador como página HTTPS de nível superior, sem sandbox nem uma política que bloqueie o script incorporado ou o iframe vazio. O iframe herda a origem da página, mas a origem do seu URL `about:blank` é `"null"`. Lê a linha JSON na consola do navegador após o evento `load`.
Lições relacionadas
- JavaScript · Lição 5 · Avançado · Versão: 4
Fontes
- 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