Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
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'interfaceWindow représente une fenêtre contenant un documentDOM ; la propriétédocument pointe vers ledocument 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'interfaceWindow 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 laRéférence JavaScript et laRéférence DOM.
Dans un navigateur à onglets, chaque onglet est représenté par son propre objetWindow ; la variable globalewindow 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, commeresizeTo() etinnerHeight. De manière générale, tout ce qui ne peut pas raisonnablement concerner un onglet concerne la fenêtre elle-même.
Dans cet article
Propriétés d'instance
Cette interface hérite des propriétés de l'interfaceEventTarget.
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 seuleContexte 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 seuleContexte sécurisé- : Retourne une référence à l'objet
CookieStorepour le contexte du document courant.
- : Retourne une référence à l'objet
Window.credentiallessLecture seuleExpérimental- : Retourne un booléen indiquant si le document courant a été chargé dans une
<iframe>sans identifiants. VoirIFrame 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 seuleExpérimentalContexte sécurisé- : Retourne une référence vers la fenêtrePicture-in-Picture du document pour le contexte du document courant.
Window.fenceLecture seuleExpé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 seuleExpérimental- : Lorsqu'uneapplication 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'uneapplication 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 seuleNon 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 seuleNon 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- : 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éesliées aux performances. Voir aussiUtiliser 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 standardLecture 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 standardLecture 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 seuleExpérimentalContexte 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érimentalLecture 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èteLecture seuleRetourne 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èteLecture seuleRetourne un objet avec des fonctions permettant d'ajouter des fournisseurs de recherche externes au navigateur.
Window.orientationObsolèteLecture seuleRetourne 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èteObtient 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'interfaceEventTarget.
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èteRetire 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érimentalCrée une récupération différée, envoyée lorsque la page est quittée (détruite ou placée dans lebfcache, ou après un délai
activateAfterfourni — selon ce qui arrive en premier.Window.find()Non standardRecherche 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 standardObtient 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érimentalContexte 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érimentalContexte 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 standardFait défiler le document du nombre de lignes indiqué.
Window.scrollByPages()Non standardFait 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érimentalContexte sécuriséAffiche un sélecteur de dossier permettant à l'utilisateur·ice de choisir un dossier.
Window.showOpenFilePicker()ExpérimentalContexte sécuriséAffiche un sélecteur de fichiers permettant à l'utilisateur·ice de choisir un ou plusieurs fichiers.
Window.showSaveFilePicker()ExpérimentalContexte sécuriséAffiche un sélecteur permettant à l'utilisateur·ice d'enregistrer un fichier.
Window.sizeToContent()Non standardAjuste 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 unecopie profonde d'une valeur donnée à l'aide de l'algorithme de clonage structuré.
Méthodes dépréciées
Window.captureEvents()ObsolèteEnregistre la fenêtre pour capturer tous les événements du type spécifié.
Window.clearImmediate()Non standardObsolèteAnnule l'exécution répétée définie avec
setImmediate().Window.releaseEvents()ObsolèteLibère la fenêtre de la capture d'événements d'un type spécifique.
Window.requestFileSystem()Non standardObsolètePermet à un site web ou une application d'accéder à un système de fichiers isolé pour son propre usage.
Window.setImmediate()Non standardObsolèteExécute une fonction après que le navigateur a terminé d'autres tâches lourdes.
Window.setResizable()Non standardObsolèteNe fait rien (no-op). Conservé pour la compatibilité avec Netscape 4.x.
Window.webkitConvertPointFromNodeToPage()Non standardObsolèteTransforme un
WebKitPointdu système de coordonnées du nœud vers celui de la page.Window.webkitConvertPointFromPageToNode()Non standardObsolèteTransforme un
WebKitPointdu système de coordonnées de la page vers celui du nœud.
Événements
Écoutez ces événements à l'aide deaddEventListener() 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 leDocument contenu dans l'objet window.
errorSe 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.
languagechangeSe déclenche sur l'objet global lorsque la langue préférée de l'utilisateur·ice change.
resizeSe déclenche lorsque la fenêtre a été redimensionnée.
storageSe 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
gamepadconnectedSe 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.
gamepaddisconnectedSe déclenche lorsque le navigateur détecte qu'une manette de jeu a été déconnectée.
Événements d'historique
hashchangeSe déclenche lorsque l'identifiant de fragment de l'URL a changé (la partie de l'URL commençant par et suivant le symbole
#).pagehideSe 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).
pagerevealSe 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 lebfcache ou leprérendu.
pageshowSe 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.
pageswapSe déclenche lorsqu'un document va être déchargé à cause d'une navigation.
popstateSe déclenche lorsque l'entrée d'historique active change.
Événements de chargement et de déchargement
beforeunloadSe déclenche lorsque la fenêtre, le document et ses ressources vont être déchargés.
loadSe 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èteSe déclenche lorsque le document ou une ressource enfant est en cours de déchargement.
Événements du manifeste
appinstalledSe déclenche lorsque le navigateur a installé une page en tant qu'application.
beforeinstallpromptSe déclenche lorsqu'un·e utilisateur·ice va être invité·e à installer une application web.
Événements de messagerie
messageSe déclenche lorsque la fenêtre reçoit un message, par exemple via
Window.postMessage()depuis un autre contexte de navigation.messageerrorSe déclenche lorsqu'un objet
Windowreçoit un message qui ne peut pas être désérialisé.
Événements d'impression
afterprintSe déclenche après le début de l'impression du document associé ou la fermeture de l'aperçu avant impression.
beforeprintSe déclenche lorsque le document associé va être imprimé ou affiché en aperçu avant impression.
Événements de rejet de promesse
rejectionhandledSe déclenche chaque fois qu'une promesse
PromiseJavaScript est rejetée, qu'il y ait ou non un gestionnaire pour intercepter ce rejet.unhandledrejectionSe déclenche lorsqu'une promesse
PromiseJavaScript est rejetée sans gestionnaire pour intercepter ce rejet.
Événements de défilement
scrollsnapchangeExpérimentalSe 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érimentalSe 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èteSe déclenche lorsque l'orientation du périphérique a changé.
vrdisplayactivateObsolèteNon standardSe déclenche lorsqu'un affichage peut être présenté.
vrdisplayconnectObsolèteNon standardSe déclenche lorsqu'un périphérique VR compatible a été connecté à l'ordinateur.
vrdisplaydisconnectObsolèteNon standardSe déclenche lorsqu'un périphérique VR compatible a été déconnecté de l'ordinateur.
vrdisplaydeactivateObsolèteNon standardSe déclenche lorsqu'un affichage ne peut plus être présenté.
vrdisplaypresentchangeObsolèteNon standardSe 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'objetWindow. Seuls les événements suivants le peuvent et peuvent être écoutés sur l'objetWindow :
abortauxclickbeforeinputbeforematchbeforetogglecancelcanplaycanplaythroughchangeclickclosecontextlostcontextmenucontextrestoredcopycuechangecutdblclickdragdragenddragenterdragleavedragoverdragstartdropdurationchangeemptiedendedformdatainputinvalidkeydownkeypresskeyuploadeddataloadedmetadataloadstartmousedownmouseentermouseleavemousemovemouseoutmouseovermouseuppastepauseplayplayingprogressratechangeresetscrollendsecuritypolicyviolationseekedseekingselectslotchangestalledsubmitsuspendtimeupdatetogglevolumechangewaitingwheel
Interfaces
Voir laRé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 objetsWindow, en général, seules les deux premières méthodes sont possibles, carWindow 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'objetWindow affiché commecurrentTarget.
Spécifications
| Specification |
|---|
| HTML> # the-window-object> |