Movatterモバイル変換


[0]ホーム

URL:


  1. Web
  2. Les API Web
  3. Window

Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in EnglishAlways switch to English

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.

EventTarget Window

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.

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

Window.eventObsolèteLecture seule

Retourne l'événement courant, c'est-à-dire l'événement actuellement traité par le contexte du code JavaScript, ouundefined 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.externalObsolèteLecture seule

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

Window.orientationObsolèteLecture 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'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è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é avecWindow.requestAnimationFrame.

Window.cancelIdleCallback()

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

Window.clearInterval()

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

Window.clearTimeout()

Annule l'exécution différée définie avecWindow.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 promessePromise 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 lebfcache, ou après un délaiactivateAfter 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érimentalContexte sécurisé

Retourne une promessePromise 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 objetMediaQueryList 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érimentalContexte sécurisé

Retourne une promessePromise 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é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 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 unecopie 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 standardObsolète

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

Window.releaseEvents()Obsolète

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

Window.requestFileSystem()Non standardObsolète

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

Window.setImmediate()Non standardObsolète

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

Window.setResizable()Non standardObsolète

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

Window.webkitConvertPointFromNodeToPage()Non standardObsolète

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

Window.webkitConvertPointFromPageToNode()Non standardObsolète

Transforme unWebKitPoint du 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.

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

offline

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

online

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

É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

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 lebfcache ou lepré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 viaWindow.postMessage() depuis un autre contexte de navigation.

messageerror

Se déclenche lorsqu'un objetWindow 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 promessePromise JavaScript est rejetée, qu'il y ait ou non un gestionnaire pour intercepter ce rejet.

unhandledrejection

Se déclenche lorsqu'une promessePromise JavaScript 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èteNon standard

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

vrdisplayconnectObsolèteNon standard

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

vrdisplaydisconnectObsolèteNon standard

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

vrdisplaydeactivateObsolèteNon standard

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

vrdisplaypresentchangeObsolèteNon 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'objetWindow. Seuls les événements suivants le peuvent et peuvent être écoutés sur l'objetWindow :

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éthodeEventTarget.addEventListener.
  • Assigner un gestionnaire d'événement à la propriétéoneventname de l'élément en JavaScript.
  • Ajouter un attribut préfixé paron à 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 :

  • 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 :

js
window.onresize = (e) => console.log(e.currentTarget);document.body.onresize = (e) => console.log(e.currentTarget);
html
<body onresize="console.log(event.currentTarget)"></body>

Dans les trois cas, vous verrez l'objetWindow affiché commecurrentTarget.

Spécifications

Specification
HTML
# the-window-object

Compatibilité des navigateurs

Help improve MDN

Learn how to contribute

Cette page a été modifiée le par lescontributeurs du MDN.


[8]ページ先頭

©2009-2026 Movatter.jp