Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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