Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.origin

window.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