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
- HTML Standard
- HTML Standard — APIs related to navigation and session history
- HTML Standard — Web application APIs
- HTML Standard — Loading web pages
- HTML Standard — Images
- HTML Standard — Browsers
- Official reference — developer.mozilla.org: Window / devicePixelRatio
- Official reference — developer.mozilla.org: Window / resize_event
- Official reference — developer.mozilla.org: Window / popstate_event
- Official reference — developer.mozilla.org: API / Window