CKTIS / JavaScript
Window — le contexte du document dans le navigateur
Window donne à une page accès aux interfaces du navigateur pour les pixels, les relations entre fenêtres et les événements de redimensionnement et de navigation. Découvrez la différence entre Window et WindowProxy et pourquoi l’accès entre origines reste limité.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
window.devicePixelRatio; window.self; window.parent; window.origin; window.addEventListener("resize", handler); window.addEventListener("popstate", handler); window.addEventListener("hashchange", handler);Window est l’objet global d’un document du navigateur, pas un élément d’ECMAScript. window passe par un WindowProxy qui relaie les opérations vers le Window courant. Ces interfaces ne sont pas disponibles sous le nom window dans les workers ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
Window.self (window.self) désigne le même WindowProxy que window. Window.parent désigne la fenêtre parente du cadre, ou la fenêtre elle-même pour un document de premier niveau. Cette référence ne permet pas de lire le DOM du parent : l’accès entre origines est restreint. Window.origin renvoie l’origine sérialisée de l’environnement global : en général, schéma, hôte et port éventuel. Une origine opaque donne la chaîne "null", pas la valeur null. Ce n’est ni une URL complète ni un secret d’authentification.
Window.devicePixelRatio rapporte la taille d’un pixel CSS à celle d’un pixel de l’appareil, par exemple pour redimensionner le bitmap d’un canvas. Ne supposez ni 1 ni un entier : le résultat dépend de l’affichage et du zoom de la page. CSSOM View, et non ECMAScript, en définit les détails.
Window.resize, Window.popstate et Window.hashchange désignent des événements, pas des méthodes. Utilisez addEventListener ; les propriétés de gestion sont onresize, onpopstate et onhashchange. resize signale un changement de taille de la zone d’affichage. popstate accompagne certains changements d’entrée active de l’historique, par exemple via Précédent/Suivant ; event.state donne son état. hashchange signale un changement de fragment d’URL et fournit oldURL et newURL. history.pushState() et history.replaceState() n’émettent eux-mêmes aucun de ces deux événements de navigation, même si le fragment change.
L’exemple vérifie de façon déterministe self et l’inscription de trois écouteurs. Un Event synthétique ne change ni la taille de la fenêtre, ni l’URL, ni l’historique et n’a pas les champs propres à PopStateEvent ou HashChangeEvent. isTrusted vaut false ; aucune navigation réelle n’est testée.
Exemples
(() => {
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));
}
})();Résultat
self: true resize: false popstate: false hashchange: false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- 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