Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Window — il contesto del documento nel browser

Window mette a disposizione della pagina le interfacce del browser per informazioni sui pixel, relazioni tra finestre ed eventi di ridimensionamento e navigazione. Scopri la differenza tra Window e WindowProxy e perché l’accesso tra origini diverse è limitato.

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

Sintassi

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

Window è l’oggetto globale di un documento del browser, non fa parte di ECMAScript. L’accesso tramite window passa per un WindowProxy che inoltra le operazioni al Window attuale. Nei worker queste interfacce non sono disponibili come window; avere Node 24 nel repository non dimostra il supporto nel browser.

Window.self (window.self) indica lo stesso WindowProxy di window. Window.parent indica la finestra madre del frame oppure, in un documento di primo livello, la finestra stessa. Il riferimento non autorizza a leggere il DOM della finestra madre: l’accesso tra origini diverse è limitato. Window.origin restituisce l’origine serializzata dell’ambiente globale: in genere schema, host ed eventuale porta. Un’origine opaca dà la stringa "null", non il valore null. Non è né un URL completo né un segreto di autenticazione.

Window.devicePixelRatio è il rapporto tra la dimensione di un pixel CSS e quella di un pixel del dispositivo, utile per scalare una bitmap del canvas. Non dare per scontato 1 o un intero: dipende dall’ambiente di visualizzazione e dallo zoom della pagina. I dettagli sono definiti da CSSOM View, non da ECMAScript.

Window.resize, Window.popstate e Window.hashchange indicano eventi, non metodi. Usa addEventListener; le proprietà dei gestori sono onresize, onpopstate e onhashchange. resize segnala un cambio di dimensioni del viewport. popstate accompagna alcuni cambi della voce attiva della cronologia, per esempio con Indietro/Avanti; event.state ne espone lo stato. hashchange segnala un cambio del frammento dell’URL e fornisce oldURL e newURL. history.pushState() e history.replaceState() non emettono da sole nessuno dei due eventi di navigazione, anche se cambiano il frammento.

L’esempio verifica in modo deterministico self e la registrazione di tre listener. Un Event sintetico non modifica dimensioni della finestra, URL o cronologia e non ha i campi specifici di PopStateEvent o HashChangeEvent. isTrusted vale false; l’esempio non verifica la navigazione reale.

Esempi

(() => {
  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));
  }
})();

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti