Window
Baseline
Widely available
*
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
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.cachesLecture seule Contexte sécurisé- : Retourne l'objet
CacheStorageassocié 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.clientInformationLecture seule- : Un alias pour
Window.navigator.
- : Un alias pour
Window.closedLecture seule- : Indique si la fenêtre courante est fermée ou non.
Window.cookieStoreLecture seule Contexte sécurisé- : Retourne une référence à l'objet
CookieStorepour le contexte du document courant.
- : Retourne une référence à l'objet
Window.credentiallessLecture 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.crossOriginIsolatedLecture seule- : Retourne un booléen indiquant si le site web est en état d'isolation inter-origine.
Window.cryptoLecture seule- : Retourne l'objet
Cryptoassocié à l'objet global.
- : Retourne l'objet
Window.customElementsLecture 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.devicePixelRatioLecture seule- : Retourne le rapport entre les pixels physiques et les pixels indépendants du périphérique sur l'affichage courant.
Window.documentLecture seule- : Retourne une référence vers le document contenu dans la fenêtre.
Window.documentPictureInPictureLecture 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.fenceLecture seule Expérimental- : Retourne une instance de l'objet
Fencepour le contexte du document courant. Disponible uniquement pour les documents intégrés dans une<fencedframe>.
- : Retourne une instance de l'objet
Window.frameElementLecture 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.framesLecture seule- : Retourne un tableau des sous-fenêtres (frames) de la fenêtre courante.
Window.fullScreenNon standard- : Indique si la fenêtre est affichée en plein écran ou non.
Window.historyLecture seule- : Retourne une référence à l'objet d'historique.
Window.indexedDBLecture 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.innerHeightLecture 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.innerWidthLecture 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.isSecureContextLecture 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.launchQueueLecture seule Expérimental- : Lorsqu'une application web progressive (PWA) est lancée avec une valeur
client_modedelaunch_handlerégale àfocus-existing,navigate-newounavigate-existing, alorslaunchQueuedonne 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.lengthLecture 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.localStorageLecture 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.locationbarLecture seule- : Retourne l'objet locationbar.
Window.menubarLecture seule- : Retourne l'objet menubar.
Window.mozInnerScreenXLecture 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
mozScreenPixelsPerCSSPixeldansnsIDOMWindowUtilspour 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.mozInnerScreenYLecture 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
mozScreenPixelsPerCSSPixelpour 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.navigationLecture seule Expérimental- : Retourne l'objet
Navigationassocié à la fenêtre courante. Point d'entrée de l'API Navigation.
- : Retourne l'objet
Window.navigatorLecture 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.originLecture seule- : Retourne l'origine de l'objet global, sous forme de chaîne de caractères.
Window.originAgentClusterLecture seule- : Retourne
truesi cette fenêtre appartient à un cluster d'agent lié à une origine.
- : Retourne
Window.outerHeightLecture seule- : Obtient la hauteur extérieure de la fenêtre du navigateur.
Window.outerWidthLecture seule- : Obtient la largeur extérieure de la fenêtre du navigateur.
Window.pageXOffsetLecture seule- : Un alias pour
window.scrollX.
- : Un alias pour
Window.pageYOffsetLecture seule- : Un alias pour
window.scrollY.
- : Un alias pour
Window.parentLecture seule- : Retourne une référence au parent de la fenêtre ou sous-fenêtre courante.
Window.performanceLecture seule- : Retourne un objet
Performance, qui inclut les attributstimingetnavigation, 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.personalbarLecture seule- : Retourne l'objet personalbar.
Window.schedulerLecture seule- : Retourne l'objet
Schedulerassocié au contexte courant. Point d'entrée pour utiliser l'API Prioritized Task Scheduling.
- : Retourne l'objet
Window.screenLecture seule- : Retourne une référence à l'objet screen associé à la fenêtre.
-
Window.screenXandWindow.screenLeftLecture 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.screenYandWindow.screenTopLecture 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.scrollbarsLecture seule- : Retourne l'objet scrollbars.
Window.scrollMaxXNon 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.scrollMaxYNon 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.scrollXLecture seule- : Retourne le nombre de pixels déjà défilés horizontalement dans le document.
Window.scrollYLecture seule- : Retourne le nombre de pixels déjà défilés verticalement dans le document.
Window.selfLecture 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.sharedStorageLecture seule Expérimental Contexte sécurisé- : Retourne l'objet
WindowSharedStoragepour 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.speechSynthesisLecture seule- : Retourne un objet
SpeechSynthesis, point d'entrée pour utiliser la synthèse vocale de l'API Web Speech.
- : Retourne un objet
Window.statusbarLecture seule- : Retourne l'objet statusbar.
Window.toolbarLecture seule- : Retourne l'objet toolbar.
Window.topLecture 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.trustedTypesLecture seule- : Retourne l'objet
TrustedTypePolicyFactoryassocié à l'objet global, point d'entrée pour utiliser l'API Trusted Types.
- : Retourne l'objet
Window.viewportExpé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.visualViewportLecture seule- : Retourne un objet
VisualViewportreprésentant la zone d'affichage visuelle (visual viewport en anglais) pour une fenêtre donnée.
- : Retourne un objet
Window.windowLecture seule- : Retourne une référence à la fenêtre courante.
-
window[0],window[1], etc.- : Retourne une référence à l'objet
windowdans les frames. VoirWindow.framespour 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
HTMLCollectioncontenant tous ces éléments est renvoyé. Si l'un des éléments est une<iframe>ou un<object>navigable, alors la propriétécontentWindowdu 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.eventObsolète Lecture seule-
Retourne l'événement courant, c'est-à-dire l'événement actuellement traité par le contexte du code JavaScript, ou
undefinedsi aucun événement n'est en cours de traitement. Il est recommandé d'utiliser l'objetEventpassé directement aux gestionnaires d'événements. Window.externalObsolète Lecture seule-
Retourne un objet avec des fonctions permettant d'ajouter des fournisseurs de recherche externes au navigateur.
Window.orientationObsolè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.statusObsolè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
Promiseré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
activateAfterfourni — 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
Promiserésolue avec une instance de l'objetScreenDetailsrepré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
MediaQueryListrepré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
Promiserésolue avec un tableau d'objetsFontDatarepré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
WebKitPointdu système de coordonnées du nœud vers celui de la page. Window.webkitConvertPointFromPageToNode()Non standard Obsolète-
Transforme un
WebKitPointdu 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 (
localStorageousessionStorage) a été modifiée dans le contexte d'un autre document.
Événements de connexion
Événements d'orientation de l'appareil
devicemotionContexte 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.
deviceorientationContexte 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.
deviceorientationabsoluteContexte 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.
unloadObsolè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
Windowreç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
PromiseJavaScript est rejetée, qu'il y ait ou non un gestionnaire pour intercepter ce rejet. unhandledrejection-
Se déclenche lorsqu'une promesse
PromiseJavaScript est rejetée sans gestionnaire pour intercepter ce rejet.
Événements de défilement
scrollsnapchangeExpé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.
scrollsnapchangingExpé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
orientationchangeObsolète-
Se déclenche lorsque l'orientation du périphérique a changé.
vrdisplayactivateObsolète Non standard-
Se déclenche lorsqu'un affichage peut être présenté.
vrdisplayconnectObsolète Non standard-
Se déclenche lorsqu'un périphérique VR compatible a été connecté à l'ordinateur.
vrdisplaydisconnectObsolète Non standard-
Se déclenche lorsqu'un périphérique VR compatible a été déconnecté de l'ordinateur.
vrdisplaydeactivateObsolète Non standard-
Se déclenche lorsqu'un affichage ne peut plus être présenté.
vrdisplaypresentchangeObsolè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 :
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
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é
oneventnamede 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 :
afterprintbeforeprintbeforeunloadblurerrorfocushashchangelanguagechangeloadmessagemessageerrorofflineonlinepagehidepagerevealpageshowpageswappopstaterejectionhandledresizescrollstorageunhandledrejectionunload
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
Chargement…