recursal/MDN huggingface dataset:
windows.get()
=============

Obtient les détails sur une fenêtre, compte tenu de son identifiant. Les détails sont transmis à un rappel.

Il s'agit d'une fonction asynchrone qui renvoit une `Promise`.

Syntaxe
-------


```js
var getting = browser.windows.get(
  windowId, // integer
  getInfo, // optional object
);
```

### Paramètres

`windowId`

`integer`. L'ID de l'objet de fenêtre souhaité est retourné.

`getInfo`Facultatif

`object`. Contient des options pour filtrer le type de fenêtre.

`populate`Facultatif

`boolean`. Si c'est vrai, l'objet `windows.Window` aura une propriété de tabulation qui contient une liste d'objets `tabs.Tab` représentant les onglets ouverts dans la fenêtre. Les objets Tab ne contiennent que les propriétés `url`, `title` et `favIconUrl` i le fichier manifeste de l'extension comprend la permission `"tabs"`.

`windowTypes`Facultatif

`Ensemble d'objets` `windows.WindowType`. Si défini, le retour de `windows.Window` sera filtré en fonction de son type. Si désactivé, le filtre par défaut est réglé sur `['normal', 'panel', 'popup']`, avec des types de fenêtres `'panel'` qui sont limités aux propres fenêtres de l'extension.


**Note :**

Si fourni, le composant `windowTypes` de `getInfo` est ignoré. L'utilisation de `windowTypes` a été dépréciée à partir de Firefox 62.

### Valeur de retour

Une `Promise` qui sera remplie avec un objet `windows.Window` contenant les détails de la fenêtre. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

Exemples
--------

Cet exemple obtient la fenêtre actuelle et enregistre les URL des onglets qu'il contient. Notez que vous aurez besoin des permission "onglets" pour accéder aux URL des onglets.

**Note :** Cet exemple est un peu irréaliste: dans cette situation, vous utiliserez probablement `windows.getCurrent()`.


```js
function logTabs(windowInfo) {
  for (tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var getting = browser.windows.get(tab.windowId, { populate: true });
  getting.then(logTabs, onError);
});
```

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

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

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.getCurrent()
====================

Obtient la fenêtre actuelle du navigateur, en passant ses détails dans un rappel.

La fenêtre "actuelle" n'est pas nécessairement la même que la fenêtre ayant actuellement le focus. Si cette fonction est appelée à partir d'un script en arrière-plan, elle renvoie la fenêtre ayant actuellement le focus. Mais s'il est appelé à partir d'un script dont le document est associé à une fenêtre de navigateur particulière, il retourne la fenêtre de ce navigateur. Par exemple, si le navigateur affiche une barre latérale, chaque fenêtre de navigateur possède sa propre instance du document de la barre latérale. Si un script exécuté dans le document de la barre latérale appelle `getCurrent()`, il renverra la fenêtre de ce document de la barre latérale.

Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var gettingCurrent = browser.windows.getCurrent(
  getInfo, // optional object
);
```

### Paramètres

`getInfo`Facultatif

`object`.

`populate`Facultatif

`boolean`. Si c'est vrai, l'objet `windows.Window` aura une propriété de tabulation contenant une liste d'objets `tabs.Tab` représentant les onglets de la fenêtre. Les objets Tab ne contiennent que les propriétés `url`, `title` et `favIconUrl` si le fichier manifest de l'extension comprend la permission `"tabs"`.

`windowTypes`Facultatif

Un ensemble d'objets ``windows.WindowType``. Si défini, le `windows.Window` retourné sera filtré en fonction de son type. Si désactivé, le filtre par défaut est réglé sur `['normal', 'panel', 'popup']`, avec des types de fenêtres `'panneau'` qui sont limités aux propres fenêtres de l'extension.


**Note :**

Si fourni, le composant `windowTypes` de `getInfo` est ignoré. L'utilisation de `windowTypes` a été dépréciée à partir de Firefox 62.

### Valeur retournée

Une `Promise` qui sera remplie avec un objet `windows.Window` object contenant les détails de la fenêtre. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

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

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

Exemples
--------

Lorsque l'utilisateur clique sur l'icône d'une action du navigateur, cet exemple obtient la fenêtre actuelle et enregistre les URL des onglets qu'elle contient. Notez que vous aurez besoin de la permission "tabs" pour accéder aux URL des onglets.


```js
function logTabs(windowInfo) {
  for (let tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var getting = browser.windows.getCurrent({ populate: true });
  getting.then(logTabs, onError);
});
```

### Example extensions

* annotate-page
* theme-integrated-sidebar
* window-manipulator

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.WindowType
==================

Le type de la fenêtre du navigateur est comme çà.

Type
----

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

* `"normal"`
* `"popup"`
* `"panel"`
* `"devtools"`
Compatibilité des navigateurs
-----------------------------

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

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.WindowState
===================

L'état de cette fenêtre du navigateur.

Type
----

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont:

`"normal"`

La fenêtre est à la taille par défaut ou à la taille sélectionnée par l'utilisateur.

`"minimized"`

La fenêtre n'est visible que sous la forme d'une icône dans la barre des tâches ou .

`"maximized"`

La fenêtre remplit l'écran sur lequel elle est affichée sans inclure les zones d'écran réservées par le système d'exploitation.

`"fullscreen"`

La fenêtre s'exécute en plein écran ou le contenu d'un onglet utilise l'API Fullscreen

`"docked"`

Une fenêtre ancrée occupe une position fixe par rapport aux autres fenêtres appartenant à la même application.

Compatibilité macOS : A partir de macOS 10.10, le comportement de maximisation par défaut pour les fenêtres a été modifié pour exécuter les applications en plein écran au lieu des fenêtres "zoomées". `fullscreen` fait référence à la fois au navigateur fonctionnant en plein écran et lorsque le contenu dans un onglet utilise l'API Fullscreen.

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

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

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.WINDOW\_ID\_CURRENT
===========================

`browser.windows.WINDOW_ID_CURRENT` est une valeur qui peut être utilisée comme paramètre `windowId` dans certaines APIs pour représenter la fenêtre courante.

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

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

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.Window
==============

Informations sur une fenêtre du navigateur.

Type
----

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

`alwaysOnTop`

`boolean`. Que la fenêtre soit configurée pour toujours être sur le dessus.

`focused`

`boolean`. Que la fenêtre soit actuellement la fenêtre ciblée.

`height`Facultatif

`integer`. La hauteur de la fenêtre, y compris le cadre, en pixels.


`id`Facultatif

`integer`. L'ID de la fenêtre. Les identifiants de fenêtre sont uniques dans une session de navigateur.

`incognito`

`boolean`. Que la fenêtre soit incognito (privé).

`left`Facultatif

`integer`. Le décalage de la fenêtre du bord gauche de l'écran en pixels.

`sessionId`Facultatif

`string`. L'ID de session utilisé pour identifier de manière unique une fenêtre obtenue à partir de l'API `sessions`.

`state`Facultatif

Une valeur `windows.WindowState` représentant l'état de cette fenêtre du navigateur - maximisé, minimisé, etc.

`tabs`Facultatif

Tableau d'objets `tabs.Tab` représentant les onglets courants dans la fenêtre.

`title` Facultatif

Le titre de la fenêtre du navigateur. Nécessite la permission "tabs". Lecture seulement.

`top`Facultatif

`integer`. Le décalage de la fenêtre du bord supérieur de l'écran en pixels.

`type`Facultatif

Une valeur `windows.WindowType` représentant le type de fenêtre du navigateur, c'est-à-dire — fenêtre normale du navigateur, fenêtre contextuelle, etc.

`width`Facultatif

`integer`. La largeur de la fenêtre, y compris le cadre, en pixels.

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

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

**Note :**

Cette API est basée sur l'API de Chromium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.remove()
================

Ferme une fenêtre et tous les onglets à l'intérieur, compte tenu de l'ID de la fenêtre.

Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var removing = browser.windows.remove(
  windowId, // integer
);
```

### Paramètres

`windowId`

`integer`. ID of the window to close.

### Valeur retournée

Une `Promesse` qui sera remplie sans arguments lorsque la fenêtre a été fermée. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

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

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

Exemples
--------

Lorsque l'utilisateur clique sur l'icône d'une action du navigateur, fermez la fenêtre dans laquelle l'icône a été cliquée:


```js
function onRemoved() {
  console.log(`Removed window`);
}

function onError(error) {
  console.error(`Error:`, error);
}

browser.browserAction.onClicked.addListener((tab) => {
  var removing = browser.windows.remove(tab.windowId);
  removing.then(onRemoved, onError);
});
```


Fermez la fenêtre en cours, par exemple une fenêtre contextuelle, lorsque l'utilisateur clique sur un bouton de la page :


```js
// in a script loaded by the page in the window
document.querySelector("#close").addEventListener(async ({ button }) => {
  try {
    if (button) return; // not a left click
    const windowId = (await browser.windows.getCurrent()).id;
    await browser.windows.remove(windowId);
    // this point will never be reached, since the window is gone
  } catch (error) {
    console.error("Closing failed:", error);
  }
});
```


Dans Firefox, la même chose pourrait être réalisée avec la propriété de création de fenêtre `.allowScriptsToClose` et `window.close()`.

### Example extensions

* window-manipulator

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.WINDOW\_ID\_NONE
========================

La valeur `windowId` que représente l'absence d'une fenêtre du navigateur.

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

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

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.getAll()
================

Obtient des informations sur toutes les fenêtres ouvertes, en les passant dans un rappel.

Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var gettingAll = browser.windows.getAll(
  getInfo, // optional object
);
```

### Paramètres

`getInfo`Facultatif

`object`. Cela contrôle ce que les objets `windows.Window` sont récupérés.

`populate`Facultatif

`boolean` Par défaut à `false`. S'il est défini sur `true`, chaque objet `windows.Window` aura une propriété `tabs` qui contient une liste d'objets `tabs.Tab` représentant les tabs de cette fenêtre. Les objets `Tab` contiendront les propriétés `url`, `title` et `favIconUrl` uniquement si le fichier manifest de l'extension contient les permissions `"tabs"`.

`windowTypes`Facultatif

`Un ensemble d'objets` `windows.WindowType`. Si cette option est définie, les objets `windows.Window` renvoyés seront filtrés en fonction de leur type. Si désactivé, le filtre par défaut est réglé sur `['normal', 'panel', 'popup']`, avec des types de fenêtres `'panel'` qui sont limités aux propres fenêtres de l'extension.


### Valeur retournée

Une `Promise` qui sera remplie avec un ensemble d'objets `windows.Window`, représentant toutes les fenêtres qui correspondent aux critères donnés. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

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

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

Exemples
--------

Enregistrez les URL pour les onglets sur toutes les fenêtres de navigateur "normales". Notez que vous aurez besoin de permission "onglets" pour accéder aux URLs des onglets.


```js
function logTabsForWindows(windowInfoArray) {
  for (windowInfo of windowInfoArray) {
    console.log(`Window: ${windowInfo.id}`);
    console.log(
      windowInfo.tabs.map((tab) => {
        return tab.url;
      }),
    );
  }
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var getting = browser.windows.getAll({
    populate: true,
    windowTypes: ["normal"],
  });
  getting.then(logTabsForWindows, onError);
});
```

### Example extensions

* private-browsing-theme
* window-manipulator

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.onFocusChanged
======================

Attiré lorsque la fenêtre actuellement change. Sera `windows.WINDOW_ID_NONE` si toutes les fenêtres du navigateur ont perdu le focus.

**Note :** Sur certains gestionnaires de fenêtres Linux, WINDOW\_ID\_NONE sera toujours envoyé immédiatement avant un passage d'une fenêtre de navigateur à l'autre.

Syntaxe
-------


```js
browser.windows.onFocusChanged.addListener(listener);
browser.windows.onFocusChanged.removeListener(listener);
browser.windows.onFocusChanged.hasListener(listener);
```


Les événements ont trois événements :

`addListener(callback)`

Ajoute un auditeur à cet événement

`removeListener(listener)`

Arrêtez d'écouter cet événement. L'argument de l'auditeur est l'auditeur à supprimer.

`hasListener(listener)`

Vérifiez si un auditeur est enregistré pour cet événement. Renvoie **vrai** si elle écoute, **faux** sinon..

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lors de l'événement. La fonction passera les arguments suivants :

`windowId`

`integer`. ID de la fenêtre nouvellement localisée.


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

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

Exemples
--------

Changements de mise au point du journal :


```js
browser.windows.onFocusChanged.addListener((windowId) => {
  console.log("Newly focused window: " + windowId);
});
```

### Example extensions

* bookmark-it

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.onCreated
=================

Lancer quand la fenêtre est créée

Syntaxe
-------


```js
browser.windows.onCreated.addListener(listener);
browser.windows.onCreated.removeListener(listener);
browser.windows.onCreated.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un auditeur à cet événement.

`removeListener(listener)`

Arrêter d'écouter cet événement. L'argument de l'auditeur est l'auditeur à supprimer.

`hasListener(listener)`

Vérifiez si un auditeur est enregistré pour cet événement. Renvoie vrai si elle répond, Faux sinon.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lors de l'événement. La fonction passera les arguments suivants :

`window`

Un objet `windows.Window` contenant les détails de la fenêtre qui a été créée.


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

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

Exemples
--------

Enregistrez les ID des nouvelles fenêtres lorsqu'elles sont créées


```js
browser.windows.onCreated.addListener((window) => {
  console.log("New window: " + window.id);
});
```

### Example extensions

* private-browsing-theme

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.getLastFocused()
========================

Obtient la fenêtre qui a été recentrée récemment — généralement la fenêtre 'en haut'.

Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var gettingWindow = browser.windows.getLastFocused(
  getInfo, // optional object
);
```

### Paramètres

`getInfo`Facultatif

`object`.

`populate`Facultatif

`boolean`. Si c'est vrai, l'objet `windows.Window` aura une propriété de tabulation contenant une liste d'objets `tabs.Tab` représentant les onglets de la fenêtre. Les objets d'onglets ne contiennent que les propriétés `url`, `title` et `favIconUrl` si le fichier manifest de l'extension comprend la permission `"tabs"`.

`windowTypes`Facultatif

Un ensemble d'objets `windows.WindowType`. Si défini, le `windows.Window` retourné sera filtré en fonction de son type. Si désactivé, le filtre par défaut est réglé sur `['normal', 'panel', 'popup']`, avec le type de fenêtre `'panel'` qui sont limités aux propres fenêtres de l'extension.


**Note :**

Si fourni, le composant `windowTypes` de `getInfo` est ignoré. L'utilisation de `windowTypes` a été dépréciée à partir de Firefox 62.

### Valeur retournée

`Une Promise` qui sera remplie avec un objet `windows.Window` contenant les détails de la dernière fenêtre ciblée. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

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

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

Exemples
--------

Obtenez la dernière fenêtre ciblée et enregistrez les onglets qu'elle contient. Notez que vous aurez besoin de la permission "tabs" pour accéder aux URL des onglets.


```js
function logTabs(windowInfo) {
  for (tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var getting = browser.windows.getLastFocused({ populate: true });
  getting.then(logTabs, onError);
});
```


**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.CreateType
==================

Spécifie le type de fenêtre du navigateur à créer.

Type
----

Les valeurs de ce type sont des objets `strings`. Les valeurs possibles sont :

* `"normal"`
* `"popup"`
* `"panel"`
* `"detached_panel"`
Compatibilité des navigateurs
-----------------------------

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

**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.
windows.onRemoved
=================

Lancer quand une fenêtre est fermée.

Syntaxe
-------


```js
browser.windows.onRemoved.addListener(listener);
browser.windows.onRemoved.removeListener(listener);
browser.windows.onRemoved.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un auditeur à cet événement.

`removeListener(listener)`

Arrêter d'écouter cet événement. L'argument de l'auditeur est l'auditeur supprimer.

`hasListener(listener)`

Vérifie si un auditeur est enregistré pour cet événement. Renvoie vrai si elle écoute, faux sinon.

Syntaxe addListener
-------------------

### Paramètres

`callback`

Fonction qui sera appelée lors de l'événement. La fonction passera les arguments suivants :

`windowId`

`integer`. ID de la fenêtre fermée.


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

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

Exemples
--------

Enregistrer les identifiants de la fenêtre lorsqu'ils sont supprimés


```js
browser.windows.onRemoved.addListener((windowId) => {
  console.log("Closed window: " + windowId);
});
```


**Note :**

Cette API est basée sur l'API de Chromnium `chrome.windows`. Cette documentation provient de `windows.json` dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.