recursal/MDN huggingface dataset:
Window.back()
=============

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

**Obsolète:** Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

La méthode obsolète et non standard `back()` sur l'objet `window` renvoie la fenêtre à l'élément précédent de l'historique. Il s'agissait d'une méthode spécifique à Firefox et a été supprimée dans Firefox 31.

**Note :** Utilisez plutôt la méthode standard `history.back` (en-US).

Syntaxe
-------


```js
window.back();
```

### Paramètres

Aucun.

### Valeur de retour

`undefined`.

Exemple
-------

Cet exemple simple gère un clic sur un bouton "Retour" en rappelant `back()`.


```js
function boutonRetour() {
  if (peutRevenirEnArriere) {
    window.back();
  }
}
```

Spécification
-------------

Cela ne fait partie d'aucune spécification.

Compatibilité des navigateurs
-----------------------------

Cette méthode non standard n'a été implémentée que dans Firefox et a été supprimée dans Firefox 31.

Voir aussi
----------

* `History.back()` (en-US)
* `History.forward()` (en-US)
Window : méthode confirm()
==========================

`window.confirm()` indique au navigateur d'afficher une boîte de dialogue avec un message optionnel et d'attendre que la personne confirme ou annule la boîte de dialogue.

Sous certaines conditions, par exemple au changement d'onglet, le navigateur pourra ne pas afficher la boîte de dialogue ou ne pas attendre la confirmation ou l'annulation.

Syntaxe
-------


```js
confirm(message)
```

### Paramètres

`message`

Une chaîne de caractères qu'on souhaite afficher dans la boîte de dialogue de confirmation.

### Valeur de retour

Un booléen qui indique si l'option « OK » (`true`) ou « Annuler » (`false`) a été sélectionnée. Si le navigateur ignore les boîtes de dialogue, la valeur renvoyée est toujours `false`.

Exemples
--------


```js
if (window.confirm("Souhaitez-vous vraiment quitter le site ?")) {
  window.open("exit.html", "Merci de votre visite !");
}
```


Créera le résultat suivant :

![Confirmation dans Firefox](/fr/docs/Web/API/Window/confirm/firefoxcomfirmdialog_zpsf00ec381.png)

Notes
-----

Ces boîtes de dialogue sont des fenêtres modales qui empêchent d'accéder au reste de l'interface utilisateur du programme, à moins que la boîte de dialogue soit fermée. Aussi, il ne faut pas abuser de cette fonction.

Il y a également d'autres raisons d'éviter les boîtes de dialogue pour demander une confirmation.

Une autre méthode consiste à utiliser l'élément HTML `<dialog>` afin d'afficher des demandes de confirmation.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-confirm-dev |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'élément `<dialog>`
* `window.alert()`
* `window.prompt()`
Window : l'événement deviceorientation
======================================

L'événement `deviceorientation` est déclenché lorsque des données sont disponibles, à partir d'un capteur d'orientation, sur l'orientation actuelle de l'appareil par rapport au cadre de coordonnées de la Terre. Ces données sont recueillies à partir d'un magnétomètre à l'intérieur de l'appareil. Voir Données d'orientation et de mouvement expliquées pour plus de détails.

|  |  |
| --- | --- |
| Propagation | Non |
| Annulable | Non |
| Interface | `DeviceOrientationEvent` |
| Propriété du gestionnaire d'événements | `window.ondeviceorientation` (en-US) |

Exemple
-------


```js
if (window.DeviceOrientationEvent) {
  window.addEventListener(
    "deviceorientation",
    function (event) {
      // alpha : rotation autour de l'axe z
      var rotateDegrees = event.alpha;
      // gamma : de gauche à droite
      var leftToRight = event.gamma;
      // bêta : mouvement avant-arrière
      var frontToBack = event.beta;

      handleOrientationEvent(frontToBack, leftToRight, rotateDegrees);
    },
    true,
  );
}

var handleOrientationEvent = function (
  frontToBack,
 leftToRight,
 rotateDegrees,
) {
  // faire quelque chose d'étonnant
};
```

Spécifications
--------------

| Specification |
| --- |
| DeviceOrientation Event Specification # deviceorientation |
| DeviceOrientation Event Specification # ref-for-dom-window-ondeviceorientation |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* L'événement `devicemotion`
* Détection de l'orientation des appareils. (en-US)
* Explication des données d'orientation et de mouvement
* Simulation d'événements d'orientation sur les navigateurs de bureau avec orientation-devtool.
Window.scrollTo()
=================

La méthode **`Window.scrollTo()`** permet de faire défiler la fenêtre pour atteindre les coordonnées données dans le document.

Syntaxe
-------


```js
scrollTo(x_coord, y_coord);
scrollTo(options);
```

### Paramètres

`x_coord`

Le pixel sur l'axe horizontal du document dont on veut qu'il soit affiché dans le coin supérieur gauche.

`y_coord`

Le pixel sur l'axe vertical du document dont on veut qu'il soit affiché dans le coin supérieur gauche.

ou

`options`

Un dictionnaire avec les paramètres suivants :

`top`

Indique le nombre de pixels le long desquels faire défiler la fenêtre ou l'élément sur l'axe vertical.

`left`

Indique le nombre de pixels le long desquels faire défiler la fenêtre ou l'élément sur l'axe horizontal.

`behavior`

Indique si le défilement devrait être instantané ou doux. Cette option est une chaine de caractères qui doit être l'une de ces valeurs :

* `smooth` : le défilement doit s'animer en douceur
* `instant` : le défilement devrait se produire instantanément, en un seul saut
* `auto` : le comportement de défilement est déterminé par la valeur calculée de (scroll-behavior)


### Valeur de retour

Aucune (`undefined`).

Exemples
--------

### Usage simple


```js
window.scrollTo(0, 1000);
```

### En utilisant `options`


```js
window.scrollTo({
  top: 100,
  left: 100,
  behavior: "smooth",
});
```

Notes
-----

`Window.scroll()` est la même que cette méthode. Pour le défilement relatif, voir les méthodes `Window.scrollBy()`, `Window.scrollByLines()`, et `Window.scrollByPages()`.

Pour le défilement des éléments, voir `Element.scrollTop` et `Element.scrollLeft`.

Spécifications
--------------

| Specification |
| --- |
| CSSOM View Module # dom-window-scrollto |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window.screen
=============

Retourne une référence à l'objet `screen` associé à la fenêtre. L'object `screen`, qui implémente l'interface `Screen` (en-US), est un objet spécial servant à examiner les propriétés de l'écran qui affiche la fenêtre courante.Syntaxe
-------


```js
objetEcran = window.screen;
```

Examples
--------


```js
if (screen.pixelDepth < 8) {
  // utiliser la page en colorisation réduite
} else {
  // utiliser la page en coolorisation normale
}
```

Spécifications
--------------

| Specification |
| --- |
| CSSOM View Module # dom-window-screen |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window.document
===============

**`window.document`** renvoie une référence au document contenu dans la fenêtre.

Exemple
-------


```js
console.log(window.document.title);
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-document-dev |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window.focus()
==============

Résumé
------

Demande la mise au premier plan de la fenêtre. Cet appel peut échouer en fonction des réglages utilisateurs, et ne garantit pas que la fenêtre sera au-dessus des autres au retour de cette méthode.

Syntaxe
-------


```js
window.focus();
```

Exemple
-------


```js
if (clicked) {
  window.focus();
}
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-window-focus-dev |
Window.customElements
=====================

Limited availability
--------------------

This feature is not Baseline because it does not work in some of the most widely-used browsers.

* Learn more
* See full compatibility
* Report feedback
La propriété en lecture seule `customElements` de l'interface `Window` renvoie une référence à l'objet `CustomElementRegistry` (en-US), qui peut être utilisée pour enregistrer de nouveaux éléments personnalisés et obtenir des informations sur des éléments personnalisés enregistrés.

Syntaxe
-------


```js
let registreElementsPersonnalises = window.customElements;
```

### Valeur retournée

Une instance d'objet `CustomElementRegistry` (en-US) représentant le registre des éléments personnalisés pour la fenêtre en cours.

Exemples
--------

L'exemple le plus courant d'utilisation de cette propriété que vous verrez sera d'obtenir l'accès à la méthode `CustomElementRegistry.define()` pour définir et enregistrer un nouvel élément personnalisé, par exemple :


```js
let registreElementsPersonnalises = window.customElements;
registreElementsPersonnalises.define(
  "mon-element-personnalise",
  MonElementPersonnalise,
);
```


Cependant, il est généralement raccourci en quelque chose comme :


```js
customElements.define(
  "details-element",
  class extends HTMLElement {
    constructor() {
      super();
      const modele = document.getElementById("modele-details-element").content;
      const racineOmbre = this.attachShadow({ mode: "open" }).appendChild(
        template.cloneNode(true),
      );
    }
  },
);
```


Voir notre repo web-components-examples pour davantage d'exemples d'utilisation.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # dom-window-customelements |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
window.innerWidth
=================

Résumé
------

 Récupère la largeur du contenu visible de la fenêtre de navigation en incluant, s'il est visible, l'ascenseur vertical.
 Permet également de fixer une largeur pour le domaine d'affichage de la fenêtre.

Syntaxe
-------


```js
var largeur = window.innerWidth;
```


Voir aussi : window.innerHeight, window.outerHeight and window.outerWidth.

Valeur renvoyée
---------------

`innerWidth`

un entier (nombre de pixels);

Notes
-----

La propriété `innerWidth` est supportée par tous les objet "window" comme par exemple une fenêtre, une frame, un frameset, ou une fenêtre secondaire.

Example
-------


```js
// Retourne la largeur de la fenêtre
var largeur = window.innerWidth;

// Retourn la largeur de la fenêtre à l'intérieur d'une "frameset"
var largeur = self.innerWidth;

// Retourne la largeur de la fenêtre du "frameset" parent
var largeurDeLaFrame = parent.innerWidth;

// Retourne la largeur de la fenêtre du "frameset" principal
var largeurDuFrameset = top.innerWidth;
```


Pour changer la taille de la fenêtre, voir `window.resizeBy` and `window.resizeTo` (en-US).

Spécifications
--------------

| Specification |
| --- |
| CSSOM View Module # dom-window-innerwidth |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window: paste event
===================

L'événement **`paste`** est déclenché lorsque l'utilisateur a lancé une action de "paste" via l'interface utilisateur du navigateur.

|  |  |
| --- | --- |
| Bulles | Yes |
| Annulable | Yes |
| Interface | `ClipboardEvent` (en-US) |
| Propriété du gestionnaire d'événements | `onpaste` (en-US) |

La cible d'origine de cet événement est le `Element` qui était la cible prévue de l'action de collage. Vous pouvez écouter cet événement sur l'interface `Window` pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur le Element: paste event (en-US).

Exemples
--------


```js
window.addEventListener("paste", (event) => {
  console.log("paste action initiated");
});
```

Spécifications
--------------

| Specification |
| --- |
| Clipboard API and events # clipboard-event-paste |
| HTML Standard # handler-onpaste |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Événements liés: `cut`, `copy`
* Cet événement sur `Element` cible: `paste` (en-US)
* Cet événement sur `Document` cible: `paste` (en-US)
Window: Evenement offline
=========================

L'événement **`offline`** de l'interface `Window` se déclenche lorsque le navigateur perd la connexion au réseau et la valeur de `Navigator.onLine` bascule à `false`.

|  |  |
| --- | --- |
| Bulles | Non |
| Annulable | Non |
| Interface | `Event` |
| Propriété de gestionnaire d'événements | `onoffline` |

Exemples
--------


```js
//version addEventListener
window.addEventListener("offline", (event) => {
  console.log("La Connexion au réseau est perdu.");
});

// onoffline version
window.onoffline = (event) => {
  console.log("La Connexion au réseau a été perdue.");
};
```

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # event-offline |
| HTML Standard # handler-window-onoffline |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `online`
Window.scrollByLines()
======================

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Fait défiler le document du nombre de lignes spécifié.

Syntaxe
-------


```js
window.scrollByLines(lignes);
```

Paramètres
----------

* `lignes` est le nombre de lignes à faire défiler.
* `lignes` peut être un entier positif ou négatif.
Exemples
--------


```html
<!-- Faire défiler le document de 5 lignes vers le bas. -->
<button onclick="scrollByLines(5);">5 lignes vers le bas</button>
```



```html
<!-- Faire défiler le document de 5 lignes vers le haut. -->
<button onclick="scrollByLines(-5);">5 lignes vers le haut</button>
```

Spécification
-------------

Ne fait partie d'aucune spécification.

Voir aussi
----------

* `window.scrollBy`, `window.scrollByPages`
Window.print()
==============

Ouvre la boîte de dialogue pour imprimer le document actuel.

Si le chargement du document est toujours en cours lorsque cette fonction est appelée, l'ouverture de la boîte de dialogue attendra la fin du chargement.

Cette méthode sera bloquante pour le reste de l'exécution tant que la boîte de dialogue pour l'impression restera ouverte.

Syntaxe
-------


```js
print();
```

### Paramètres

Aucun.

### Valeur de retour

Aucune (`undefined`).

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # printing |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Guide sur l'impression (en-US)
* L'évènement `beforeprint`
* L'évènement `afterprint`
Window: vrdisplayconnect event
==============================

L'événement **`vrdisplayconnect`** de l'API WebVR est déclenché lorsqu'un écran VR compatible est connecté à l'ordinateur.

|  |  |
| --- | --- |
| Bulles | Non |
| Annulable | Non |
| Interface | `VRDisplayEvent` (en-US) |
| Propriété de gestionnaire d'événements | `onvrdisplayconnect (en-US)` |

Exemples
--------

Vous pouvez utiliser l'événement `vrdisplayconnect` dans une méthode `addEventListener` :


```js
window.addEventListener("vrdisplayconnect", function () {
  info.textContent = "Affichage connecté.";
  reportDisplays();
});
```


Ou utilisez la propriété du gestionnaire d'événements `onvrdisplayconnect` (en-US) :


```js
window.onvrdisplayconnect = function () {
  info.textContent = "Affichage connecté.";
  reportDisplays();
};
```

Spécifications
--------------

#### No specification found

No specification data found for `api.Window.vrdisplayconnect_event`.  
Check for problems with this page or contribute a missing `spec_url` to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* WebVR API
Window.resizeBy()
=================

La méthode **`Window.resizeBy()`** redimensionne la fenêtre actuelle d'une taille spécifié.

Syntaxe
-------


```js
window.resizeBy(xDelta, yDelta);
```

### Paramètres

* `xDelta` est le nombre de pixels pour agrandir la fenêtre horizontalement.
* `yDelta` est le nombre de pixels pour agrandir la fenêtre verticalement.
Exemple
-------


```js
// Réduit la fenêtre
window.resizeBy(-200, -200);
```

Notes
-----

Cette méthode redimensionne la fenêtre par rapport à sa taille actuelle. Pour redimensionner la fenêtre en termes absolus, utilisez `window.resizeTo ()`.

### Créer et redimensionner une fenêtre externe

Pour des raisons de sécurité, il n'est plus possible dans Firefox pour un site Web de modifier la taille par défaut d'une fenêtre dans un navigateur si la fenêtre n'a pas été créée par `window.open()` ou contient plusieurs onglets. Consultez le tableau de compatibilité pour plus de détails sur le changement.

Même si vous créez une fenêtre avec `window.open()` **elle n'est pas redimensionnable par défaut.** Pour rendre la fenêtre redimensionnable, vous devez l'ouvrir avec le paramètre `"resizable"` .


```js
// Créer une fenêtre redimensionnable
myExternalWindow = window.open(
  "http://myurl.domain",
  "myWindowName",
  "resizable",
);

// Redimensionner la fenêtre à 500 x 500
myExternalWindow.resizeTo(500, 500);

// Rendre la fenêtre relativement plus petit à 400 x 400
myExternalWindow.resizeBy(-100, -100);
```


La fenêtre que vous créez doit respecter la politique de même origine. Si la fenêtre que vous ouvrez n'est pas dans la même origine que la fenêtre actuelle, vous ne pourrez pas redimensionner ni accéder aux informations sur cette fenêtre / cet onglet.

Spécifications
--------------

| Specification |
| --- |
| CSSOM View Module # dom-window-resizeby |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.
Window: copy event
==================

L'événement **`copy`** se déclenche lorsque l'utilisateur lance une action de copie via l'interface utilisateur du nagivateur.

|  |  |
| --- | --- |
| Bulles | Oui |
| Annulable | Oui |
| Interface | `ClipboardEvent` (en-US) |
| Propriété de gestionnaire d'événement | `oncopy` (en-US) |

La cible d'origine de cet événement est le `Element` qui était la cible prévue de l'action de copie. Vous pouvez écouter cet événement sur l'interface `Window` pour le gérer dans les phases de capture ou de bullage. Pour plus de détails sur cet événement, veuillez consulter la page sur le Element: copy event.

Exemples
--------


```js
window.addEventListener("copy", (event) => {
  console.log("action de copie lancée");
});
```

Spécifications
--------------

| Specification |
| --- |
| Clipboard API and events # clipboard-event-copy |
| HTML Standard # handler-oncopy |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* Événements liés: `cut`, `paste`
* Cet événement sur `Element` cible: `copy`
* Cet événement sur `Document` cible: `copy` (en-US)
Window.event
============

L'événement de propriété `Window` en lecture seule renvoie le `Event` qui est actuellement géré par le code du site. En dehors du contexte d'un gestionnaire d'événements, la valeur est toujours `undefined`.

Vous devez éviter d'utiliser cette propriété dans un nouveau code et utiliser à la place le `Event` transmis à la fonction de gestionnaire d'événements. Cette propriété n'est pas prise en charge universellement et même lorsqu'elle est prise en charge, elle introduit une fragilité potentielle dans votre code.

**Note :** Cette propriété peut être fragile, dans la mesure où il peut y avoir des situations dans lesquelles `l'événement` renvoyé n'est pas la valeur attendue. De plus, `Window.event` n'est pas précis pour les événements distribués dans shadow trees (en-US).

Spécifications
--------------

| Specification |
| --- |
| DOM Standard # dom-window-event |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `Event.srcElement`
Window.find()
=============

**Non standard:** Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

**Note :** La prise en charge de `Window.find()` pourrait changer dans les futures versions de Gecko. Voir bug Firefox 672395.

La méthode **`Window.find()`** trouve une chaîne dans une fenêtre.

Syntaxe
-------


```js
window.find(
  aString,
  aCaseSensitive,
  aBackwards,
  aWrapAround,
  aWholeWord,
  aSearchInFrames,
  aShowDialog,
);
```


`aString`

La chaîne de caractère à rechercher.

`aCaseSensitive`

`Boolean`. Si `true`, spécifie une recherche sensible à la casse.

`aBackwards`

`Boolean`. Si `true`, spécifie une recherche vers l'arrière.

`aWrapAround`

`Boolean`. Si `true`, spécifie une recherche enveloppante.

`aWholeWord` Non implémenté

`Boolean`. Si `true`, spécifie une recherche de mot entier. Ceci n'est pas implémenté; voir bug Firefox 481513.

`aSearchInFrames`

`Boolean`. Si `true`, spécifie une recherche dans les cadres.

### Retourne

`true` si la chaîne est trouvé; autrement, `false`.

Exemple
-------

### JavaScript


```js
findString = function findText(text) {
  alert("String \x22" + text + "\x22 found? " + window.find(text));
};
```

### HTML


```html
<p>Apples, Bananas, and Oranges.</p>
<button type="button" onClick='findString("Apples")'>Search for Apples</button>
<button type="button" onClick='findString("Banana")'>Search for Banana</button>
<button type="button" onClick='findString("Orange")'>Search for Orange</button>
```

### Résultat

Notes
-----

Dans certains navigateurs, `Window.find()` sélectionne (met en évidence) le contenu trouvé sur le site.

Spécification
-------------

Cela ne fait partie d'aucune spécification.

Compatibilité des navigateurs
-----------------------------

Cette méthode fonctionne dans de nombreux navigateurs modernes, notamment Firefox, Chrome, et Safari.