Window

Propriétés d'instance

Cette interface hérite des propriétés de l'interface EventTarget.

Notez que les propriétés qui sont des objets (par exemple, pour surcharger le prototype d'éléments natifs) sont listées dans une section séparée ci-dessous.

Window.caches Lecture seule Contexte sécurisé

Retourne l'objet CacheStorage associé au contexte courant. Cet objet permet, par exemple, de stocker des ressources pour une utilisation hors ligne et de générer des réponses personnalisées aux requêtes.

Window.clientInformation Lecture seule

Un alias pour Window.navigator.

Window.closed Lecture seule

Indique si la fenêtre courante est fermée ou non.

Window.cookieStore Lecture seule Contexte sécurisé

Retourne une référence à l'objet CookieStore pour le contexte du document courant.

Window.crashReport Lecture seule Contexte sécurisé

Retourne un objet CrashReportContext qui permet d'enregistrer des données arbitraires pour le contexte de navigation de niveau supérieur actuel, qui sont ensuite ajoutées à un CrashReport et envoyées à un point de rapport en cas de plantage du navigateur.

Window.credentialless Lecture seule

Retourne un booléen indiquant si le document courant a été chargé dans une <iframe> sans identifiants. Voir IFrame credentialless pour plus de détails.

Window.crossOriginIsolated Lecture seule

Retourne un booléen indiquant si le site web est en état d'isolation inter-origine.

Window.crypto Lecture seule

Retourne l'objet Crypto associé à l'objet global.

Window.customElements Lecture seule

Retourne une référence à l'objet CustomElementRegistry, qui permet d'enregistrer de nouveaux éléments personnalisés et d'obtenir des informations sur ceux déjà enregistrés.

Window.devicePixelRatio Lecture seule

Retourne le rapport entre les pixels physiques et les pixels indépendants du périphérique sur l'affichage courant.

Window.document Lecture seule

Retourne une référence vers le document contenu dans la fenêtre.

Window.documentPictureInPicture Lecture seule Contexte sécurisé

Retourne une référence vers la fenêtre Picture-in-Picture du document pour le contexte du document courant.

Window.fence Lecture seule

Retourne une instance de l'objet Fence pour le contexte du document courant. Disponible uniquement pour les documents intégrés dans une <fencedframe>.

Window.frameElement Lecture seule

Retourne l'élément dans lequel la fenêtre est intégrée, ou null si la fenêtre n'est pas intégrée.

Window.frames Lecture seule

Retourne un tableau des sous-fenêtres (frames) de la fenêtre courante.

Window.fullScreen

Indique si la fenêtre est affichée en plein écran ou non.

Window.history Lecture seule

Retourne une référence à l'objet d'historique.

Window.indexedDB Lecture seule

Fournit un mécanisme permettant aux applications d'accéder de façon asynchrone aux bases de données indexées ; Retourne un objet IDBFactory.

Window.innerHeight Lecture seule

Obtient la hauteur de la zone de contenu de la fenêtre du navigateur, y compris, si elle est affichée, la barre de défilement horizontale.

Window.innerWidth Lecture seule

Obtient la largeur de la zone de contenu de la fenêtre du navigateur, y compris, si elle est affichée, la barre de défilement verticale.

Window.isSecureContext Lecture seule

Retourne un booléen indiquant si le contexte courant est sécurisé (true) ou non (false).

Window.launchQueue Lecture seule

Lorsqu'une application web progressive (PWA) est lancée avec une valeur client_mode de launch_handler égale à focus-existing, navigate-new ou navigate-existing, alors launchQueue donne accès à la classe LaunchQueue, permettant d'implémenter une gestion personnalisée de la navigation au lancement de la PWA.

Window.length Lecture seule

Retourne le nombre de frames dans la fenêtre. Voir aussi window.frames.

Window.localStorage Lecture seule

Retourne une référence à l'objet de stockage local utilisé pour stocker des données accessibles uniquement par l'origine qui les a créées.

Window.location

Obtient ou définit l'emplacement (URL courante) de l'objet window.

Window.locationbar Lecture seule

Retourne l'objet locationbar.

Window.menubar Lecture seule

Retourne l'objet menubar.

Window.mozInnerScreenX Lecture seule

Retourne la coordonnée horizontale (X) du coin supérieur gauche de la zone d'affichage (viewport en anglais) de la fenêtre, en coordonnées écran. Cette valeur est exprimée en pixels CSS. Voir mozScreenPixelsPerCSSPixel dans nsIDOMWindowUtils pour convertir en pixels écran si besoin.

Window.mozInnerScreenY Lecture seule

Retourne la coordonnée verticale (Y) du coin supérieur gauche de la zone d'affichage (viewport en anglais) de la fenêtre, en coordonnées écran. Cette valeur est exprimée en pixels CSS. Voir mozScreenPixelsPerCSSPixel pour convertir en pixels écran si besoin.

Window.name

Obtient ou définit le nom de la fenêtre.

Window.navigation Lecture seule

Retourne l'objet Navigation associé à la fenêtre courante. Point d'entrée de l'API Navigation.

Window.navigator Lecture seule

Retourne une référence à l'objet navigator.

Window.opener

Retourne une référence à la fenêtre qui a ouvert la fenêtre courante.

Window.origin Lecture seule

Retourne l'origine de l'objet global, sous forme de chaîne de caractères.

Window.originAgentCluster Lecture seule

Retourne true si cette fenêtre appartient à un cluster d'agent lié à une origine.

Window.outerHeight Lecture seule

Obtient la hauteur extérieure de la fenêtre du navigateur.

Window.outerWidth Lecture seule

Obtient la largeur extérieure de la fenêtre du navigateur.

Window.pageXOffset Lecture seule

Un alias pour window.scrollX.

Window.pageYOffset Lecture seule

Un alias pour window.scrollY.

Window.parent Lecture seule

Retourne une référence au parent de la fenêtre ou sous-fenêtre courante.

Window.performance Lecture seule

Retourne un objet Performance, qui inclut les attributs timing et navigation, chacun fournissant des données liées aux performances. Voir aussi Utiliser Navigation Timing pour plus d'informations et d'exemples.

Window.personalbar Lecture seule

Retourne l'objet personalbar.

Window.scheduler Lecture seule

Retourne l'objet Scheduler associé au contexte courant. Point d'entrée pour utiliser l'API Prioritized Task Scheduling.

Window.screen Lecture seule

Retourne une référence à l'objet screen associé à la fenêtre.

Window.screenX and Window.screenLeft Lecture seule

Les deux propriétés Retournent la distance horizontale entre le bord gauche de la zone d'affichage (viewport en anglais) du navigateur de l'utilisateur·ice et le bord gauche de l'écran.

Window.screenY and Window.screenTop Lecture seule

Les deux propriétés Retournent la distance verticale entre le bord supérieur de la zone d'affichage (viewport en anglais) du navigateur de l'utilisateur·ice et le bord supérieur de l'écran.

Window.scrollbars Lecture seule

Retourne l'objet scrollbars.

Window.scrollMaxX Lecture seule

Le décalage maximal auquel la fenêtre peut être défilée horizontalement, c'est-à-dire la largeur du document moins la largeur de la zone d'affichage (viewport en anglais).

Window.scrollMaxY Lecture seule

Le décalage maximal auquel la fenêtre peut être défilée verticalement (c'est-à-dire la hauteur du document moins la hauteur de la zone d'affichage (viewport en anglais)).

Window.scrollX Lecture seule

Retourne le nombre de pixels déjà défilés horizontalement dans le document.

Window.scrollY Lecture seule

Retourne le nombre de pixels déjà défilés verticalement dans le document.

Window.self Lecture seule

Retourne une référence à l'objet window lui-même.

Window.sessionStorage

Retourne une référence à l'objet de stockage de session utilisé pour stocker des données accessibles uniquement par l'origine qui les a créées.

Window.sharedStorage Lecture seule Contexte sécurisé

Retourne l'objet WindowSharedStorage pour l'origine courante. Point d'entrée principal pour écrire des données dans le stockage partagé avec l'API Shared Storage.

Window.speechSynthesis Lecture seule

Retourne un objet SpeechSynthesis, point d'entrée pour utiliser la synthèse vocale de l'API Web Speech.

Window.statusbar Lecture seule

Retourne l'objet statusbar.

Window.toolbar Lecture seule

Retourne l'objet toolbar.

Window.top Lecture seule

Retourne une référence à la fenêtre la plus haute dans la hiérarchie des fenêtres. Cette propriété est en lecture seule.

Window.trustedTypes Lecture seule

Retourne l'objet TrustedTypePolicyFactory associé à l'objet global, point d'entrée pour utiliser l'API Trusted Types.

Window.viewport Lecture seule

Retourne une instance d'objet Viewport, qui fournit des informations sur l'état courant de la zone d'affichage (viewport en anglais) du périphérique.

Window.visualViewport Lecture seule

Retourne un objet VisualViewport représentant la zone d'affichage visuelle (visual viewport en anglais) pour une fenêtre donnée.

Window.window Lecture seule

Retourne une référence à la fenêtre courante.

window[0], window[1], etc.

Retourne une référence à l'objet window dans les frames. Voir Window.frames pour plus de détails.

Propriétés nommées

Certains éléments du document sont également exposés comme propriétés de window :

• Pour chaque élément <embed>, <form>, <iframe>, <img> et <object>, son name (s'il n'est pas vide) est exposé. Par exemple, si le document contient <form name="my_form">, alors window["my_form"] (et son équivalent window.my_form) retourne une référence vers cet élément.
• Pour chaque élément HTML, son id (s'il n'est pas vide) est exposé.

Si une propriété correspond à un seul élément, cet élément est directement renvoyé. Si la propriété correspond à plusieurs éléments, alors un objet HTMLCollection contenant tous ces éléments est renvoyé. Si l'un des éléments est une <iframe> ou un <object> navigable, alors la propriété contentWindow du premier iframe de ce type est renvoyée à la place.

Propriétés dépréciées

Window.event Lecture seule

Retourne l'évènement courant, c'est-à-dire l'évènement actuellement traité par le contexte du code JavaScript, ou undefined si aucun évènement n'est en cours de traitement. Il est recommandé d'utiliser l'objet Event passé directement aux gestionnaires d'évènements.

Window.external Lecture seule

Retourne un objet avec des fonctions permettant d'ajouter des fournisseurs de recherche externes au navigateur.

Window.orientation Lecture seule

Retourne l'orientation, en degrés (par incréments de 90°), de la zone d'affichage (viewport en anglais) par rapport à l'orientation naturelle du périphérique.

Window.status

Obtient ou définit le texte affiché dans la barre d'état en bas du navigateur.

Méthodes d'instance

Cette interface hérite des méthodes de l'interface EventTarget.

Window.atob()

Décode une chaîne de données encodée en base 64.

Window.alert()

Affiche une boîte de dialogue d'alerte.

Window.blur()

Retire la sélection de la fenêtre.

Window.btoa()

Crée une chaîne ASCII encodée en base 64 à partir d'une chaîne de données binaires.

Window.cancelAnimationFrame()

Permet d'annuler un rappel précédemment planifié avec Window.requestAnimationFrame.

Window.cancelIdleCallback()

Permet d'annuler un rappel précédemment planifié avec Window.requestIdleCallback.

Window.clearInterval()

Annule l'exécution répétée définie avec Window.setInterval().

Window.clearTimeout()

Annule l'exécution différée définie avec Window.setTimeout().

Window.close()

Ferme la fenêtre courante.

Window.confirm()

Affiche une boîte de dialogue avec un message auquel l'utilisateur·ice doit répondre.

Window.createImageBitmap()

Accepte différentes sources d'images et Retourne une promesse Promise résolue avec un objet ImageBitmap. La source peut être recadrée à un rectangle de pixels d'origine (sx, sy) de largeur sw et hauteur sh.

Window.dump()

Écrit un message dans la console.

Window.fetch()

Démarre le processus de récupération d'une ressource sur le réseau.

Window.fetchLater()

Crée une récupération différée, envoyée lorsque la page est quittée (détruite ou placée dans le bfcache, ou après un délai activateAfter fourni — selon ce qui arrive en premier.

Window.find()

Recherche dans une chaîne de caractères donnée dans une fenêtre.

Window.focus()

Donne la sélection à la fenêtre courante.

Window.getComputedStyle()

Obtient le style calculé pour l'élément défini. Le style calculé indique les valeurs calculées de toutes les propriétés CSS de l'élément.

Window.getDefaultComputedStyle()

Obtient le style calculé par défaut pour l'élément défini, en ignorant les feuilles de style de l'auteur·ice.

Window.getScreenDetails() Contexte sécurisé

Retourne une promesse Promise résolue avec une instance de l'objet ScreenDetails représentant les détails de tous les écrans disponibles sur le périphérique de l'utilisateur·ice.

Window.getSelection()

Retourne l'objet de sélection représentant l'élément ou les éléments sélectionnés.

Window.matchMedia()

Retourne un objet MediaQueryList représentant la chaîne de requête média définie.

Window.moveBy()

Déplace la fenêtre courante d'une certaine distance.

Window.moveTo()

Déplace la fenêtre aux coordonnées définies.

Window.open()

Ouvre une nouvelle fenêtre.

Window.postMessage()

Permet à une fenêtre d'envoyer de façon sécurisée une chaîne de données à une autre fenêtre, même si elle n'est pas du même domaine.

Window.print()

Ouvre la boîte de dialogue d'impression pour imprimer le document courant.

Window.prompt()

Retourne le texte saisi par l'utilisateur·ice dans une boîte de dialogue de saisie.

Window.queryLocalFonts() Contexte sécurisé

Retourne une promesse Promise résolue avec un tableau d'objets FontData représentant les polices disponibles localement.

Window.queueMicrotask()

Place une micro-tâche dans la file d'attente pour exécution à un moment sûr avant que le contrôle ne revienne à la boucle d'évènements du navigateur.

Window.reportError()

Signale une erreur dans un script, simulant une exception non gérée.

Window.requestAnimationFrame()

Indique au navigateur qu'une animation est en cours et demande de planifier un rafraîchissement de la fenêtre pour la prochaine image d'animation.

Window.requestIdleCallback()

Permet de planifier des tâches pendant les périodes d'inactivité du navigateur.

Window.resizeBy()

Redimensionne la fenêtre courante d'une certaine valeur.

Window.resizeTo()

Redimensionne dynamiquement la fenêtre.

Window.scroll()

Fait défiler la fenêtre à un endroit particulier du document.

Window.scrollBy()

Fait défiler le document dans la fenêtre de la valeur indiquée.

Window.scrollByLines()

Fait défiler le document du nombre de lignes indiqué.

Window.scrollByPages()

Fait défiler le document courant du nombre de pages défini.

Window.scrollTo()

Fait défiler le document jusqu'aux coordonnées définies.

Window.setInterval()

Planifie l'exécution d'une fonction à chaque intervalle de temps donné en millisecondes.

Window.setTimeout()

Planifie l'exécution d'une fonction après un certain délai.

Window.showDirectoryPicker() Contexte sécurisé

Affiche un sélecteur de dossier permettant à l'utilisateur·ice de choisir un dossier.

Window.showOpenFilePicker() Contexte sécurisé

Affiche un sélecteur de fichiers permettant à l'utilisateur·ice de choisir un ou plusieurs fichiers.

Window.showSaveFilePicker() Contexte sécurisé

Affiche un sélecteur permettant à l'utilisateur·ice d'enregistrer un fichier.

Window.sizeToContent()

Ajuste la taille de la fenêtre en fonction de son contenu.

Window.stop()

Cette méthode arrête le chargement de la fenêtre.

Window.structuredClone()

Crée une copie profonde d'une valeur donnée à l'aide de l'algorithme de clonage structuré.

Méthodes dépréciées

Window.captureEvents()

Enregistre la fenêtre pour capturer tous les évènements du type défini.

Window.clearImmediate()

Annule l'exécution répétée définie avec setImmediate().

Window.releaseEvents()

Libère la fenêtre de la capture d'évènements d'un type spécifique.

Window.requestFileSystem()

Permet à un site web ou une application d'accéder à un système de fichiers isolé pour son propre usage.

Window.setImmediate()

Exécute une fonction après que le navigateur a terminé d'autres tâches lourdes.

Window.setResizable()

Ne fait rien (no-op). Conservé pour la compatibilité avec Netscape 4.x.

Window.webkitConvertPointFromNodeToPage()

Transforme un WebKitPoint du système de coordonnées du nœud vers celui de la page.

Window.webkitConvertPointFromPageToNode()

Transforme un WebKitPoint du système de coordonnées de la page vers celui du nœud.

Évènements

Écoutez ces évènements à l'aide de addEventListener() ou en assignant un écouteur d'évènement à la propriété oneventname de cette interface. En plus des évènements listés ci-dessous, de nombreux évènements peuvent remonter depuis le Document contenu dans l'objet window.

error

Se déclenche lorsqu'une ressource n'a pas pu être chargée ou utilisée. Par exemple, si un script rencontre une erreur d'exécution ou si une image est introuvable ou invalide.

languagechange

Se déclenche sur l'objet global lorsque la langue préférée de l'utilisateur·ice change.

resize

Se déclenche lorsque la fenêtre a été redimensionnée.

storage

Se déclenche lorsqu'une zone de stockage (localStorage ou sessionStorage) a été modifiée dans le contexte d'un autre document.

Évènements de connexion

offline

Se déclenche lorsque le navigateur perd l'accès au réseau et que la valeur de navigator.onLine passe à false.

online

Se déclenche lorsque le navigateur retrouve l'accès au réseau et que la valeur de navigator.onLine passe à true.

Évènements d'orientation de l'appareil

devicemotion Contexte sécurisé

Se déclenche à intervalles réguliers, indiquant la force d'accélération physique reçue par le périphérique et, si disponible, le taux de rotation.

deviceorientation Contexte sécurisé

Se déclenche lorsque de nouvelles données du capteur d'orientation du magnétomètre sont disponibles concernant l'orientation actuelle du périphérique par rapport au repère terrestre.

deviceorientationabsolute Contexte sécurisé

Se déclenche lorsque de nouvelles données du capteur d'orientation du magnétomètre sont disponibles concernant l'orientation absolue du périphérique par rapport au repère terrestre.

Évènements de ciblage

blur

Se déclenche lorsqu'un élément perd la sélection.

focus

Se déclenche lorsqu'un élément reçoit la sélection.

Évènements de manette de jeu

gamepadconnected

Se déclenche lorsque le navigateur détecte qu'une manette de jeu a été connectée ou lors de la première utilisation d'un bouton ou axe de la manette.

gamepaddisconnected

Se déclenche lorsque le navigateur détecte qu'une manette de jeu a été déconnectée.

Évènements d'historique

hashchange

Se déclenche lorsque l'identifiant de fragment de l'URL a changé (la partie de l'URL commençant par et suivant le symbole #).

pagehide

Se déclenche lorsque le navigateur masque le document courant lors du passage à un autre document de l'historique de session (par exemple, lors d'un clic sur le bouton Précédent ou Suivant).

pagereveal

Se déclenche lorsqu'un document est affiché pour la première fois, soit lors du chargement depuis le réseau, soit lors de l'activation depuis le bfcache ou le prérendu.

pageshow

Se déclenche lorsque le navigateur rend le document visible à la suite d'une navigation, que ce soit lors du premier chargement ou lors d'un retour sur la page dans le même onglet.

pageswap

Se déclenche lorsqu'un document va être déchargé à cause d'une navigation.

popstate

Se déclenche lorsque l'entrée d'historique active change.

Évènements de chargement et de déchargement

beforeunload

Se déclenche lorsque la fenêtre, le document et ses ressources vont être déchargés.

load

Se déclenche lorsque la page entière a été chargée, y compris toutes les ressources dépendantes comme les feuilles de style et les images.

unload

Se déclenche lorsque le document ou une ressource enfant est en cours de déchargement.

Évènements du manifeste

appinstalled

Se déclenche lorsque le navigateur a installé une page en tant qu'application.

beforeinstallprompt

Se déclenche lorsqu'un·e utilisateur·ice va être invité·e à installer une application web.

Évènements de messagerie

message

Se déclenche lorsque la fenêtre reçoit un message, par exemple avec Window.postMessage() depuis un autre contexte de navigation.

messageerror

Se déclenche lorsqu'un objet Window reçoit un message qui ne peut pas être désérialisé.

Évènements d'impression

afterprint

Se déclenche après le début de l'impression du document associé ou la fermeture de l'aperçu avant impression.

beforeprint

Se déclenche lorsque le document associé va être imprimé ou affiché en aperçu avant impression.

Évènements de rejet de promesse

rejectionhandled

Se déclenche chaque fois qu'une promesse Promise JavaScript est rejetée, qu'il y ait ou non un gestionnaire pour intercepter ce rejet.

unhandledrejection

Se déclenche lorsqu'une promesse Promise JavaScript est rejetée sans gestionnaire pour intercepter ce rejet.

Évènements de défilement

scrollsnapchange

Se déclenche sur le conteneur de défilement à la fin d'une opération de défilement lorsqu'une nouvelle cible d'ancrage a été sélectionnée.

scrollsnapchanging

Se déclenche sur le conteneur de défilement lorsque le navigateur détermine qu'une nouvelle cible d'ancrage est en attente, c'est-à-dire qu'elle est sélectionnée à la fin du geste de défilement en cours.

Évènements dépréciés

orientationchange

Se déclenche lorsque l'orientation du périphérique a changé.

vrdisplayactivate

Se déclenche lorsqu'un affichage peut être présenté.

vrdisplayconnect

Se déclenche lorsqu'un périphérique VR compatible a été connecté à l'ordinateur.

vrdisplaydisconnect

Se déclenche lorsqu'un périphérique VR compatible a été déconnecté de l'ordinateur.

vrdisplaydeactivate

Se déclenche lorsqu'un affichage ne peut plus être présenté.

vrdisplaypresentchange

Se déclenche lorsque l'état de présentation d'un périphérique VR change (passe de présenté à non présenté, ou inversement).

Évènements propagés

Tous les évènements qui remontent ne peuvent pas atteindre l'objet Window. Seuls les évènements suivants le peuvent et peuvent être écoutés sur l'objet Window :

• abort
• auxclick
• beforeinput
• beforematch
• beforetoggle
• cancel
• canplay
• canplaythrough
• change
• click
• close
• contextlost
• contextmenu
• contextrestored
• copy
• cuechange
• cut
• dblclick
• drag
• dragend
• dragenter
• dragleave
• dragover
• dragstart
• drop
• durationchange
• emptied
• ended
• formdata
• input
• invalid
• keydown
• keypress
• keyup
• loadeddata
• loadedmetadata
• loadstart
• mousedown
• mouseenter
• mouseleave
• mousemove
• mouseout
• mouseover
• mouseup
• paste
• pause
• play
• playing
• progress
• ratechange
• reset
• scrollend
• securitypolicyviolation
• seeked
• seeking
• select
• slotchange
• stalled
• submit
• suspend
• timeupdate
• toggle
• volumechange
• waiting
• wheel

Interfaces

Voir la Référence DOM.

Écouter des évènements sur Window

Les éléments HTML offrent trois façons d'écouter des évènements :

• Ajouter un écouteur d'évènement à l'élément avec la méthode EventTarget.addEventListener.
• Assigner un gestionnaire d'évènement à la propriété oneventname de l'élément en JavaScript.
• Ajouter un attribut préfixé par on à l'élément dans le HTML.

Pour écouter des évènements sur les objets Window, en général, seules les deux premières méthodes sont possibles, car Window n'a pas d'élément HTML correspondant. Cependant, un groupe spécifique d'évènements peut voir leurs écouteurs ajoutés à l'élément <body> (ou l'élément déprécié <frameset>) du document de la fenêtre, en utilisant la deuxième ou la troisième méthode. Ces évènements sont :

• afterprint
• beforeprint
• beforeunload
• blur
• error
• focus
• hashchange
• languagechange
• load
• message
• messageerror
• offline
• online
• pagehide
• pagereveal
• pageshow
• pageswap
• popstate
• rejectionhandled
• resize
• scroll
• storage
• unhandledrejection
• unload

Cela signifie que les exemples suivants sont strictement équivalents :

Dans les trois cas, vous verrez l'objet Window affiché comme currentTarget.

Spécifications

Spécification

HTML # the-window-object

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.