recursal/MDN huggingface dataset:
theme.onUpdated
===============

L'événement se déclenche lorsqu'un thème fourni en tant qu'extension de navigateur est appliqué ou supprimé, plus précisément :

* Quand un thème statique est installé
* Quand un thème dynamique appelle `theme.update()` ou `theme.reset()`
* Quand un thème est désinstallé

Notez que cet événement n'est pas déclenché pour les thèmes intégrés.

Syntaxe
-------


```js
browser.theme.onUpdated.addListener(listener);
browser.theme.onUpdated.removeListener(listener);
browser.theme.onUpdated.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(listener)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

Arrête d'écouter cet événement. L'argument de `listener` est l'écouteur à supprimer.

`hasListener(listener)`

Vérifie si `listener` est enregistré pour cet événement. Retourne `true` s'il écoute, sinon `false`.

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

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les paramètres suivants :

`updateInfo`

`object`. Un objet contenant deux propriétés :

`theme`

`object`. Si l'événement a été déclenché parce qu'un thème fourni par une extension a été supprimé, il s'agira d'un objet vide. Si il a été déclenché parce qu'un thème fourni par une extension a été appliqué, ce sera un objet `theme.Theme` représentant le thème qui a été appliqué.

`windowId`Facultatif

`integer`. L'ID de la fenêtre pour laquelle le thème a été mis à jour. Si cette propriété n'est pas présente, cela signifie que le thème a été mise à jour globalement.


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

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

Exemples
--------


```js
function handleUpdated(updateInfo) {
  if (updateInfo.theme.colors) {
    console.log(`Theme was applied: ${updateInfo.theme}`);
  } else {
    console.log(`Theme was removed`);
  }
}

browser.theme.onUpdated.addListener(handleUpdated);
```

### Example extensions

* theme-integrated-sidebar
alarms.getAll()
===============

Obtient toutes les alarmes actives pour le poste.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var getAlarms = browser.alarms.getAll();
```

### Paramètres

Aucun

### Valeur de retour

Une `Promise` dont la valeur de résolution sera un tableau d'objets `Alarm`. Chaque élément de ce tableau représente une alarme active de l'extension. Si aucune alarme n'est active, le tableau sera vide.

Exemples
--------


```js
function gotAll(alarms) {
  for (var alarm of alarms) {
    console.log(alarm.name);
  }
}

var getAlarms = browser.alarms.getAll();
getAlarms.then(gotAll);
```

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 Chromium `chrome.alarms`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
alarms.clear()
==============

Cette méthode supprime une alarme à partir du nom passé en argument. Il s'agit d'une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var clearAlarm = browser.alarms.clear(
  name, // string
);
```

### Paramètres

`name`Facultatif

`string`. Le nom de l'alarme à supprimer. Si le paramètre n'est pas fourni, c'est la chaîne vide "" qui sera utilisée.

### Valeur de retour

Une promesse (`Promise`) qui sera tenue avec un booléen. Ce booléen vaudra `true` si l'alarme a bien été effacée et `false` sinon.

Exemples
--------


```js
function onCleared(wasCleared) {
  console.log(wasCleared); // true/false
}

var clearAlarm = browser.alarms.clear("my-periodic-alarm");
clearAlarm.then(onCleared);
```

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

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

**Remerciements :**

Cette API est basée sur l'API Chromium `chrome.alarms`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
alarms.Alarm
============

Cette interface fournit des informations sur une alarme donnée. Cet objet est retourné à partir de `alarms.get()` et `alarms.getAll()` et est passé au gestionnaire d'évènement `alarms.onAlarm`.

Type
----

Les valeurs de ce type sont des objets contenant les propriétés suivantes :

`name`

`string` Une chaîne de caractères contenant le nom de l'alarme. Ce nom provient de celui qui a été fourni à la méthode `alarms.create()` lors de la création de l'alarme.

`scheduledTime`

`double` Un nombre qui représente l'heure à laquelle l'alarme doit être déclenchée, exprimée en nombre de millisecondes depuis epoch.

`periodInMinutes`Facultatif

`double` Un nombre qui, s'il n'est pas `null`, indique que l'alarme est périodique et fournit la période.

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

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

**Remerciements :**

Cette API est basée sur l'API Chromium `chrome.alarms`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
alarms.clearAll()
=================

Cette méthode supprime toutes les alarmes actives. C'est une fonction asynchrone qui renvoie une promesse `Promise`.

Syntaxe
-------


```js
var clearAlarms = browser.alarms.clearAll();
```

### Paramètres

Aucun.

### Valeur de retour

Une promesse (`Promise`) qui sera tenue avec une valeur booléenne. Ce dernier vaudra `true` si certaines alarmes ont bien été effacées et `false` sinon. On notera que Chrome renvoie toujours `true`.

Exemples
--------


```js
function onClearedAll(wasCleared) {
  console.log(wasCleared); // true/false
}

var clearAlarms = browser.alarms.clearAll();
clearAlarms.then(onClearedAll);
```

### Example extensions

* chill-out
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 Chromium `chrome.alarms`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
alarms.onAlarm
==============

Cet évènement est déclenché lorsque l'alarme se déclenche.

Syntaxe
-------


```js
browser.alarms.onAlarm.addListener(listener);
browser.alarms.onAlarm.removeListener(listener);
browser.alarms.onAlarm.hasListener(listener);
```


Cet évènement possède trois méthodes :

`addListener(listener)`

Cette méthode ajoute un gestionnaire à l'évènement.

`removeListener(listener)`

Cette méthode retire le gestionnaire d'évènement passé en argument.

`hasListener(listener)`

Cette méthode permet de vérifier si le gestionnaire d'évènement passé en argument est enregistré : elle renvoie `true` s'il est déjà présent et `false` sinon.

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

### Paramètres

`listener`

La fonction qui sera appelée lorsque l'événement se produira. La fonction recevra les arguments suivants :

`alarm`

`alarms.Alarm`. L'alarme qui s'est déclenchée. La propriété `Alarm.name` pourra être utilisée afin de déterminer l'alarme qui s'est déclenchée.


Exemples
--------

Voici un exemple illustrant ce qui se produit quand l'alarme se déclenche


```js
function handleAlarm(alarmInfo) {
  console.log("L'alarme " + alarmInfo.name + " s'est déclenchée");
}

browser.alarms.onAlarm.addListener(handleAlarm);
```

### Example extensions

* chill-out
* dynamic-theme
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 Chromium `chrome.alarms`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
alarms.get()
============

Cette méthode permet d'obtenir une alarme en fonction de son nom. Cette fonction est une fonction asynchrone qui renvoie une promesse (`Promise`).

Syntaxe
-------


```js
var getAlarm = browser.alarms.get(
  name, // optional string
);
```

### Paramètres

`name`Facultatif

`string`. Le nom de l'alarme qu'on souhaite récupérer. La valeur par défaut, utilisée si aucun argument n'est fournie, sera la chaîne vide (`""`).

### Valeur de retour

Une promesse (`Promise`) qui sera tenue avec un objet `Alarm`. Cette valeur correspond à l'alarme dont le nom correspond au paramètre `name`. Si aucune alarme ne correspond, la valeur renvoyée sera `undefined`.

Exemples
--------


```js
function gotAlarm(alarm) {
  if (alarm) {
    console.log(alarm.name);
  }
}

var getAlarm = browser.alarms.get("my-periodic-alarm");
getAlarm.then(gotAlarm);
```

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 Chromium `chrome.alarms`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.isShown()
====================

Renvoie `true` si l'action de la page est affichée pour l'onglet donné..

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
let gettingIsShown = browser.pageAction.isShown(
  details, // object
);
```

### Paramètres

`details`

`object`. Un objet contenant le `tabId` à vérifier.

`tabId`

`integer`. ID de l'onglet à vérifier.


### Valeur retournée

Une `Promise` qui sera remplie avec `true` si l'action de page de l'extension est affichée pour l'onglet donné, et `false` dans le cas contraire.

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

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

Exemples
--------

Vérifiez l'état de l'onglet actuellement actif :


```js
async function shownInActiveTab() {
  let tabs = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let shown = await browser.pageAction.isShown({
    tabId: tabs[0].id,
  });
  console.log(shown);
}
```
pageAction.hide()
=================

Masque l'action de page pour un onglet donné.

`hide()` remplace la correspondance de motifs, de sorte que l'action page ne sera pas affichée dans l'onglet spécifié même si son URL est associée à `show_matches`.

Syntaxe
-------


```js
browser.pageAction.hide(
  tabId, // integer
);
```

### Paramètres

`tabId`

`integer`. L'ID de l'onglet pour lequel vous souhaitez masquer l'action de la page.

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

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

Exemples
--------

Masquez l'action de la page pour l'onglet en cours lorsque l'utilisateur clique dessus :


```js
browser.pageAction.onClicked.addListener((tab) => {
  browser.pageAction.hide(tab.id);
});
```

### Example extensions

* chill-out

**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.getPopup()
=====================

Obtient l'URL d'un document HTML en tant que popup pour cette action de page.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var gettingPopup = browser.pageAction.getPopup(
  details, // object
);
```

### Paramètres

`details`

`object`.

`tabId`

`integer`. ID de l'onglet dont vous souhaitez obtenir la fenêtre contextuelle.


### Valeur retournée

Une `Promise` qui sera accompli avec une chaîne contenant l'URL du popup.

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

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

Exemples
--------

Ajoutez un élément de menu contextuel qui enregistre l'URL contextuelle de l'onglet en cours. Notez que vous aurez besoin de la permission `contextMenus` dans votre manifest pour créer des éléments de menu contextuel.


```js
function gotPopup(popupURL) {
  console.log(popupURL);
}

browser.contextMenus.create({
  id: "get-popup",
  title: "Get popup URL",
});

browser.contextMenus.onClicked.addListener(function (info, tab) {
  if (info.menuItemId == "get-popup") {
    var gettingPopup = browser.pageAction.getPopup({ tabId: tab.id });
    gettingPopup.then(gotPopup);
  }
});
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.show()
=================

Affiche l'action de la page pour un onglet donné. L'action de la page est affichée chaque fois que l'onglet donné est l'onglet actif.

`show()` remplace la correspondance de motifs, de sorte que l'action page sera affichée dans l'onglet spécifié même si `show_matches` e correspond pas à l'URL ou si `hide_matches` ne correspond pas.

Notez que l'appel à `show()` n'a aucun effet sur un onglet sans contenu chargé.

Syntaxe
-------


```js
browser.pageAction.show(
  tabId, // integer
);
```

### Paramètres

`tabId`

`integer`. L'ID de l'onglet pour lequel vous souhaitez afficher l'action de la page.

### Valeur renvoyée

Une `Promise` qui sera remplie avec `undefined`.

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

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

Exemples
--------

Cette exemple montre l'action de la page pour l'onglet actif lorsque l'utilisateur sélectionne un élément de menu contextuel. Notez que vous aurez besoin de la permission `contextMenus` dans votre manifest pour créer des éléments de menu contextuel.


```js
browser.contextMenus.create({
  id: "show",
  title: "Show page action",
});

browser.contextMenus.onClicked.addListener(function (info, tab) {
  if (info.menuItemId == "show") {
    browser.pageAction.show(tab.id);
  }
});
```

### Example extensions

* apply-css
* chill-out
* history-deleter
* menu-remove-element

**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.getTitle()
=====================

Obtient le titre de la page action.

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var gettingTitle = browser.pageAction.getTitle(
  details, // object
);
```

### Paramètres

`details`

`object`.

`tabId`

`integer`. L'ID de l'onglet contenant l'action page dont vous voulez obtenir le titre.


### Valeur retournée

Une `Promise` qui sera accomplie avec une chaîne contenant le titre de l'action de la page.

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

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

Exemples
--------

Cet exemple enregistre le titre de l'action de la page lorsque l'utilisateur clique sur son icône :


```js
function gotTitle(title) {
  console.log(`Title ${title}`);
}

browser.pageAction.onClicked.addListener((tab) => {
  var gettingTitle = browser.pageAction.getTitle({
    tabId: tab.id,
  });
  gettingTitle.then(gotTitle);
});
```

### Example extensions

* apply-css

**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.ImageDataType
========================

Données en pixel pour une image.

Type
----

Un objet `ImageData` , par exemple à partir d'un élément `<canvas>`.

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 Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.setPopup()
=====================

Définit le document HTML à ouvrir en tant que fenêtre contextuelle lorsque l'utilisateur clique sur l'icône de l'action de la page.

Syntaxe
-------


```js
browser.pageAction.setPopup(
  details, // object
);
```

### Paramètres

`details`

`object`.

`tabId`

`integer`. L'ID de l'onglet pour lequel vous souhaitez définir la fenêtre contextuelle.

`popup`

`string`. URL vers le fichier HTML à afficher dans un popup. Si elle est définie sur une chaîne vide (''), aucune fenêtre contextuelle n'est affichée.


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

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

Exemples
--------

Ecoutez les événements `tabs.onUpdated` et basculez le popup si le statut de chargement change :


```js
browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => {
  if (changeInfo.status) {
    browser.pageAction.show(tabId);
    if (changeInfo.status == "loading") {
      browser.pageAction.setPopup({
        tabId,
        popup: "/popup/loading.html",
      });
    } else {
      browser.pageAction.setPopup({
        tabId,
        popup: "/popup/complete.html",
      });
    }
  }
});
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.openPopup()
======================

Ouvrez le menu contextuel de l'action de la page.
Vous pouvez uniquement appeler cette fonction à partir du gestionnaire pour une action utilisateur.

Syntaxe
-------


```js
browser.pageAction.openPopup();
```

### Paramètres

None.

### Valeur retourné

Une `Promise` qui est résolue sans arguments.

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

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

Exemples
--------

Ouvrez la fenêtre contextuelle lorsque l'utilisateur sélectionne un élément de menu contextuel :


```js
browser.menus.create({
  id: "open-popup",
  title: "open popup",
  contexts: ["all"],
});

browser.menus.onClicked.addListener(() => {
  browser.pageAction.openPopup();
});
```

### Example extensions

* menu-remove-element
pageAction.onClicked
====================

Lancé quand l'icône de la page action est cliquée. Cet événement ne se déclenchera pas si l'action de la page comporte une fenêtre contextuelle.

Pour définir une action de clic droit, utilisez l'API `contextMenus` (en-US) avec l'élément "page\_action" context type (en-US).

Syntaxe
-------


```js
browser.pageAction.onClicked.addListener(listener);
browser.pageAction.onClicked.removeListener(listener);
browser.pageAction.onClicked.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

Arrêtez l'écouter cet événement. L'argument `listener` est l'écouteur à supprimer.

`hasListener(listener)`

Vérifie si un `listener` est enregistré pour cet événement. Retourne `true` s'il écoute, `false` sinon.

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

### Paramètres

`callback`

Une fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

`tab`

Un objet `tabs.Tab` représentant l'onglet dont l'action de la page a été cliquée.


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'action de la page, masquez-là et naviguez dans l'onglet actif pour "http://chilloutandwatchsomecatgifs.com/" :


```js
var CATGIFS = "http://chilloutandwatchsomecatgifs.com/";

browser.pageAction.onClicked.addListener((tab) => {
  browser.pageAction.hide(tab.id);
  browser.tabs.update({ url: CATGIFS });
});

browser.pageAction.onClicked.addListener(function () {});
```

### Example extensions

* apply-css
* chill-out

**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
pageAction.setTitle()
=====================

Définit le titre de la page action. Le titre est affiché dans une info-bulle lorsque l'utilisateur survole l'action de la page

Syntaxe
-------


```js
browser.pageAction.setTitle(
  details, // object
);
```

### Paramètres

`details`

`object`.

`tabId`

`integer`. L'ID de l'onglet dont vous voulez définir le titre.

`title`

`string`. Le texte de l'info-bulle.


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

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

Exemples
--------

Chaque fois qu'un onglet est mis à jour, affichez l'action de la page pour cet onglet et définissez son titre pour afficher l'ID de l'onglet :


```js
browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => {
  browser.pageAction.show(tabId);
  browser.pageAction.setTitle({
    tabId: tabId,
    title: "Tab ID: " + tabId,
  });
});
```

### Example extensions

* apply-css

**Note :**

Cette API est basée sur l'API Chromium `chrome.pageAction`. Cette documentation est dérivée de `page_action.json` dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.
identity.getRedirectURL()
=========================

Génère une URL que vous pouvez utiliser comme URL de redirection.

L'URL est dérivée de l'ID de votre extension. Si vous utilisez cette fonction, vous devrez probablement définir explicitement l'ID de votre extension à l'aide de la clé des `applications` (sinon, chaque fois que vous installerez temporairement l'extension, vous obtiendrez une URL de redirection différente).

Voir Obtenir une URL de redirection pour plus d'informations sur les URL de redirection.

Syntaxe
-------


```js
var redirectURL = browser.identity.getRedirectURL();
```

### Paramètres

None.

### Valeur retournée

Une chaîne contenant une valeur d'URL de redirection.

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

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

Exemples
--------

Obtenez l'URL de redirection :


```js
var redirectURL = browser.identity.getRedirectURL();
```

### Example extensions

* google-userinfo

**Note :**

Cette API est basée sur l'API Chromium `chrome.identity`.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.