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

CKTIS / JavaScript

Window — o contexto do documento no navegador

Window dá à página acesso a interfaces do navegador para informação sobre píxeis, relações entre janelas e eventos de redimensionamento e navegação. Percebe a diferença entre Window e WindowProxy e por que motivo o acesso entre origens é limitado.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);

Window é o objeto global de um documento do navegador, não faz parte de ECMAScript. O acesso via window usa um WindowProxy que encaminha as operações para o Window atual. Nos workers, estas interfaces não estão disponíveis como window; ter Node 24 no repositório não comprova suporte no navegador.

Window.self (window.self) aponta para o mesmo WindowProxy que window. Window.parent aponta para a janela pai da frame ou para a própria janela num documento de nível superior. A referência não permite ler o DOM da janela pai: o acesso entre origens é limitado. Window.origin devolve a origem serializada do ambiente global: normalmente esquema, anfitrião e porta opcional. Uma origem opaca dá a cadeia "null", não o valor null. Não é um URL completo nem um segredo de autenticação.

Window.devicePixelRatio é a razão entre o tamanho de um píxel CSS e o de um píxel do dispositivo, útil para ajustar a escala do bitmap de um canvas. Não assumas 1 nem um inteiro: depende do ambiente de visualização e do zoom da página. É CSSOM View, não ECMAScript, que define os detalhes.

Window.resize, Window.popstate e Window.hashchange são nomes de eventos, não de métodos. Usa addEventListener; as propriedades dos manipuladores são onresize, onpopstate e onhashchange. resize assinala uma mudança no tamanho da área visível. popstate acompanha certas mudanças da entrada ativa do histórico, como ao recuar ou avançar; event.state dá o estado da entrada. hashchange assinala uma mudança do fragmento do URL e fornece oldURL e newURL. history.pushState() e history.replaceState() não emitem por si só nenhum dos dois eventos de navegação, mesmo que alterem o fragmento.

O exemplo verifica de forma determinística self e o registo de três listeners. Um Event sintético não altera o tamanho da janela, o URL ou o histórico nem tem os campos próprios de PopStateEvent ou HashChangeEvent. isTrusted é false; o exemplo não testa a navegação real.

Exemplos

(() => {
  console.log(`self: ${window.self === window}`);
  for (const type of ["resize", "popstate", "hashchange"]) {
    window.addEventListener(type, (event) => {
      console.log(`${event.type}: ${event.isTrusted}`);
    }, { once: true });
    window.dispatchEvent(new Event(type));
  }
})();

Resultado

self: true
resize: false
popstate: false
hashchange: false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes