Window
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since juillet 2015.
* Some parts of this feature may have varying levels of support.
L'interface Window
représente une fenêtre contenant un document DOM ; la propriété document
pointe vers le document DOM chargé dans cette fenêtre.
Vous pouvez obtenir la fenêtre d'un document donné à l'aide de la propriété document.defaultView
.
Une variable globale, window
, représentant la fenêtre dans laquelle le script s'exécute, est exposée au code JavaScript.
L'interface Window
regroupe de nombreuses fonctions, espaces de noms, objets et constructeurs qui ne sont pas forcément liés directement à la notion de fenêtre d'interface utilisateur. Cependant, c'est l'endroit approprié pour inclure ces éléments qui doivent être disponibles globalement. Beaucoup d'entre eux sont documentés dans la Référence JavaScript et la Référence DOM.
Dans un navigateur à onglets, chaque onglet est représenté par son propre objet Window
; la variable globale window
vue par le code JavaScript exécuté dans un onglet représente toujours cet onglet. Cela dit, même dans un navigateur à onglets, certaines propriétés et méthodes s'appliquent à la fenêtre globale qui contient l'onglet, comme resizeTo()
et innerHeight
. De manière générale, tout ce qui ne peut pas raisonnablement concerner un onglet concerne la fenêtre elle-même.
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.
- : Retourne l'objet
Window.clientInformation
Lecture seule- : Un alias pour
Window.navigator
.
- : Un alias pour
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.
- : Retourne une référence à l'objet
Window.credentialless
Lecture seule Expérimental- : 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.
- : Retourne un booléen indiquant si le document courant a été chargé dans une
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.
- : Retourne l'objet
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.
- : Retourne une référence à l'objet
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 Expérimental 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 Expérimental- : Retourne une instance de l'objet
Fence
pour le contexte du document courant. Disponible uniquement pour les documents intégrés dans une<fencedframe>
.
- : Retourne une instance de l'objet
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
Non standard- : 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
.
- : Fournit un mécanisme permettant aux applications d'accéder de façon asynchrone aux bases de données indexées ; Retourne un objet
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
).
- : Retourne un booléen indiquant si le contexte courant est sécurisé (
Window.launchQueue
Lecture seule Expérimental- : Lorsqu'une application web progressive (PWA) est lancée avec une valeur
client_mode
delaunch_handler
égale àfocus-existing
,navigate-new
ounavigate-existing
, alorslaunchQueue
donne accès à la classeLaunchQueue
, permettant d'implémenter une gestion personnalisée de la navigation au lancement de la PWA.
- : Lorsqu'une application web progressive (PWA) est lancée avec une valeur
Window.length
Lecture seule- : Retourne le nombre de frames dans la fenêtre. Voir aussi
window.frames
.
- : Retourne le nombre de frames dans la fenêtre. Voir aussi
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 Non standard- : 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
dansnsIDOMWindowUtils
pour convertir en pixels écran si besoin.
- : 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
Window.mozInnerScreenY
Lecture seule Non standard- : 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.
- : 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
Window.name
- : Obtient ou définit le nom de la fenêtre.
Window.navigation
Lecture seule Expérimental- : Retourne l'objet
Navigation
associé à la fenêtre courante. Point d'entrée de l'API Navigation.
- : Retourne l'objet
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.
- : Retourne
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
.
- : Un alias pour
Window.pageYOffset
Lecture seule- : Un alias pour
window.scrollY
.
- : Un alias pour
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 attributstiming
etnavigation
, chacun fournissant des données liées aux performances. Voir aussi Utiliser Navigation Timing pour plus d'informations et d'exemples.
- : Retourne un objet
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.
- : Retourne l'objet
Window.screen
Lecture seule- : Retourne une référence à l'objet screen associé à la fenêtre.
-
Window.screenX
andWindow.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
andWindow.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
Non standard 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
Non standard 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 Expérimental 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.
- : Retourne l'objet
Window.speechSynthesis
Lecture seule- : Retourne un objet
SpeechSynthesis
, point d'entrée pour utiliser la synthèse vocale de l'API Web Speech.
- : Retourne un objet
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.
- : Retourne l'objet
Window.viewport
Expérimental 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.
- : Retourne une instance d'objet
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.
- : Retourne un objet
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. VoirWindow.frames
pour plus de détails.
- : Retourne une référence à l'objet
-
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>
, sonname
(s'il n'est pas vide) est exposé. Par exemple, si le document contient<form name="my_form">
, alorswindow["my_form"]
(et son équivalentwindow.my_form
) renverra une référence vers cet élément. - Pour chaque élément HTML, son
id
(s'il n'est pas vide) est exposé.
- Pour chaque élément
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. - : Certains éléments du document sont également exposés comme propriétés de window :
Propriétés dépréciées
Window.event
Obsolète 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'objetEvent
passé directement aux gestionnaires d'événements. Window.external
Obsolète Lecture seule-
Retourne un objet avec des fonctions permettant d'ajouter des fournisseurs de recherche externes au navigateur.
Window.orientation
Obsolète 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
Obsolète-
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()
Obsolète-
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 objetImageBitmap
. La source peut être recadrée à un rectangle de pixels d'origine (sx, sy) de largeur sw et hauteur sh. Window.dump()
Non standard-
É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()
Expérimental-
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()
Non standard-
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 spécifié. Le style calculé indique les valeurs calculées de toutes les propriétés CSS de l'élément.
Window.getDefaultComputedStyle()
Non standard-
Obtient le style calculé par défaut pour l'élément spécifié, en ignorant les feuilles de style de l'auteur·ice.
Window.getScreenDetails()
Expérimental Contexte sécurisé-
Retourne une promesse
Promise
résolue avec une instance de l'objetScreenDetails
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 spécifiée. Window.moveBy()
-
Déplace la fenêtre courante d'une certaine distance.
Window.moveTo()
-
Déplace la fenêtre aux coordonnées spécifiées.
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()
Expérimental Contexte sécurisé-
Retourne une promesse
Promise
résolue avec un tableau d'objetsFontData
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()
Non standard-
Fait défiler le document du nombre de lignes indiqué.
Window.scrollByPages()
Non standard-
Fait défiler le document courant du nombre de pages spécifié.
Window.scrollTo()
-
Fait défiler le document jusqu'aux coordonnées spécifiées.
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()
Expérimental Contexte sécurisé-
Affiche un sélecteur de dossier permettant à l'utilisateur·ice de choisir un dossier.
Window.showOpenFilePicker()
Expérimental Contexte sécurisé-
Affiche un sélecteur de fichiers permettant à l'utilisateur·ice de choisir un ou plusieurs fichiers.
Window.showSaveFilePicker()
Expérimental Contexte sécurisé-
Affiche un sélecteur permettant à l'utilisateur·ice d'enregistrer un fichier.
Window.sizeToContent()
Non standard-
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()
Obsolète-
Enregistre la fenêtre pour capturer tous les événements du type spécifié.
Window.clearImmediate()
Non standard Obsolète-
Annule l'exécution répétée définie avec
setImmediate()
. Window.releaseEvents()
Obsolète-
Libère la fenêtre de la capture d'événements d'un type spécifique.
Window.requestFileSystem()
Non standard Obsolète-
Permet à un site web ou une application d'accéder à un système de fichiers isolé pour son propre usage.
Window.setImmediate()
Non standard Obsolète-
Exécute une fonction après que le navigateur a terminé d'autres tâches lourdes.
Window.setResizable()
Non standard Obsolète-
Ne fait rien (no-op). Conservé pour la compatibilité avec Netscape 4.x.
Window.webkitConvertPointFromNodeToPage()
Non standard Obsolète-
Transforme un
WebKitPoint
du système de coordonnées du nœud vers celui de la page. Window.webkitConvertPointFromPageToNode()
Non standard Obsolète-
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
ousessionStorage
) a été modifiée dans le contexte d'un autre document.
Événements de connexion
É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
É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
Obsolète-
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 via
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
Expérimental-
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
Expérimental-
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 sera sélectionnée à la fin du geste de défilement en cours.
Événements dépréciés
orientationchange
Obsolète-
Se déclenche lorsque l'orientation du périphérique a changé.
vrdisplayactivate
Obsolète Non standard-
Se déclenche lorsqu'un affichage peut être présenté.
vrdisplayconnect
Obsolète Non standard-
Se déclenche lorsqu'un périphérique VR compatible a été connecté à l'ordinateur.
vrdisplaydisconnect
Obsolète Non standard-
Se déclenche lorsqu'un périphérique VR compatible a été déconnecté de l'ordinateur.
vrdisplaydeactivate
Obsolète Non standard-
Se déclenche lorsqu'un affichage ne peut plus être présenté.
vrdisplaypresentchange
Obsolète Non standard-
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 :
window.onresize = (e) => console.log(e.currentTarget);
document.body.onresize = (e) => console.log(e.currentTarget);
<body onresize="console.log(event.currentTarget)"></body>
Dans les trois cas, vous verrez l'objet Window
affiché comme currentTarget
.
Spécifications
Specification |
---|
HTML> # the-window-object> |
Compatibilité des navigateurs
Loading…