recursal/MDN huggingface dataset:
browserAction.ImageDataType
===========================

Données en pixels pour une image. Doit être un objet `ImageData` (par exemple, un élément `<canvas>`).

Type
----

Un objet `ImageData`.

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.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.getBadgeTextColor()
=================================

Obtient la couleur du texte du badge de l'action du navigateur.

A partir de Firefox 63, à moins que la couleur du texte du badge ne soit explicitement définie à l'aide de `browserAction.setBadgeTextColor()`, la couleur du texte du badge sera automatiquement définie en noir ou blanc afin d'optimiser le contraste avec la couleur de fond du badge spécifié. Par exemple, si vous définissez la couleur de fond du badge sur blanc, la couleur par défaut du texte du badge sera définie sur noir, et vice versa.

Les autres navigateurs utilisent toujours une couleur de texte blanche.

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

Syntaxe
-------


```js
browser.browserAction.getBadgeTextColor(
  details, // object
);
```

### Paramètres

`details`

`object`

`tabId`Facultatif

`integer`. Spécifie l'onglet pour obtenir la couleur du texte du badge.

`windowId`Facultatif

`integer`. Spécifie la fenêtre à partir de laquelle obtenir la couleur du texte du badge.



* Si `windowId` et `tabId` sont tous deux fournis, la fonction échoue.
* SI `windowId` et `tabId` sont tous deux omis, la couleur globale du texte du badge est retournée.
### Valeur retournée

Une `Promise` qui sera remplie avec la couleur récupérée comme un `browserAction.ColorArray`.

Exemples
--------

Enregistrer la couleur du texte du badge :


```js
function onGot(color) {
  console.log(color);
}

function onFailure(error) {
  console.log(error);
}

browser.browserAction.getBadgeTextColor({}).then(onGot, onFailure);
```

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.browserAction`. Cette documentation est dérivée de `browser_action.json` dans le code de Chromium code.
browserAction.getPopup()
========================

Obtient le document HTML défini comme la popup pour cette action du navigateur.

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

Syntaxe
-------


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

### Paramètres

`details`

`object`.

`tabId`Facultatif

`integer`. L'onglet dont le menu déroulant reçoit un entier.

`windowId`Facultatif

`integer`. Les fenêtres dont le popup à obtenir.



* Si `windowId` et `tabId` sont tous les deux fournis, la fonction échoue.
* Si `windowId` et `tabId` sont tous deux omis, la fenêtre contextuelle globale est retournée.
### Valeur retournée

Une `Promise` qui sera remplie avec une chaine cntenant l'URL du document contextuel. Ce sera une URL entièrement qualifiée, telle que `moz-extension://d1d8a2eb-fe60-f646-af30-a866c5b39942/popups/popup2.html`.

Exemples
--------

Obtenez l'URL du Popup:


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

var gettingPopup = browser.browserAction.getPopup({});
gettingPopup.then(gotPopup);
```

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.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.disable()
=======================

Désactive l'action du navigateur pour un onglet, ce qui signifie qu'il ne peut pas être cliqué lorsque cet onglet est actif.

Syntaxe
-------


```js
browser.browserAction.disable(
  tabId, // optional integer
);
```

### Paramètres

`tabId`Facultatif

`integer`. L'identifiant (ID) de l'onglet pour lequel vous souhaitez désactiver l'action du navigateur.

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

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

Exemples
--------

Désactive l'action du navigateur lorsque vous cliquez et réactivez-le chaque fois qu'un nouveau onglet est ouvert :


```js
browser.tabs.onCreated.addListener(() => {
  browser.browserAction.enable();
});

browser.browserAction.onClicked.addListener(() => {
  browser.browserAction.disable();
});
```


Désactivez l'action du navigateur uniquement pour l'onglet actif :


```js
browser.browserAction.onClicked.addListener((tab) => {
  browser.browserAction.disable(tab.id);
});
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.setBadgeText()
============================

Définit le texte du badge pour l'action du navigateur. Le badge est affiché en haut de l'icône.

Les onglets sans texte de badge spécifique hériteront du texte global du badge, qui est `""` par défaut.

Syntaxe
-------


```js
browser.browserAction.setBadgeText(
  details, // object
);
```


Cette API est également disponible sous `chrome.browserAction.setBadgeText()`.

### Paramètres

`details`

`object`

`text`

`string` or `null`. N'importe quel nombre de caractères peut être passé, mais seulement quatre environ peuvent tenir dans l'espace.

Utilisez une chaîne vide - `""` - si vous ne voulez pas de badge.

Si un `tabId` est spécifié, `null` supprime le texte du badge spécifique à l'onglet afin que l'onglet hérite du texte global du badge. Dans le cas contraire, le texte du badge global devient `""`.

Si un `windowId` est spécifié, `null` supprime le texte du badge spécifique à la fenêtre afin que l'onglet hérite du texte global du badge. Dans le cas contraire, le texte du badge global devient `""`.

`tabId`Facultatif

`integer`. Définir le texte du badge uniquement pour l'onglet donné. Le texte est réinitialisé lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page.

`windowId`Facultatif

`integer`. Définir le texte du badge pour la fenêtre donnée.



* si `windowId` et `tabId` sont tous les deux fournis, la fonction échoue.
* si `windowId` et `tabId` sont tous les deux omis, le badge global est défini.
Exemples
--------

Ajouter un badge indiquant combien de fois l'utilisateur a cliqué sur le bouton :


```js
var clicks = 0;

function increment() {
  browser.browserAction.setBadgeText({ text: (++clicks).toString() });
}

browser.browserAction.onClicked.addListener(increment);
```

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

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

### Example extensions

* tabs-tabs-tabs

**Note :**

Cette API est basée sur l'API Chromium `chrome.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.getBadgeBackgroundColor()
=======================================

Obtient la couleur d'arrière plan du badge de l'action du navigateur.

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

Syntaxe
-------


```js
browser.browserAction.getBadgeBackgroundColor(
  details, // object
);
```

### Paramètres

`details`

`object`

`tabId`Facultatif

`integer`. Specifie l'onglet pour obtenir la couleur d'arrière-plan du badge.

`windowId`Facultatif

`integer`. Spécifie la fenêtre à partir de laquelle obtenir la couleur de fond du badge.

* Si `windowId` et `tabId` sont tous les deux fournis, la fonction échoue..
* Si `windowId` et `tabId` sont tous les deux omis, la couleur de fond du badge global est retournée.
### Valeur retournée

Une `Promise` qui sera remplie avec la couleur récupérée en tant que `browserAction.ColorArray`.

Exemples
--------

Enregistrez la couleur de fond du badge :


```js
function onGot(color) {
  console.log(color);
}

function onFailure(error) {
  console.log(error);
}

browser.browserAction.getBadgeBackgroundColor({}).then(onGot, onFailure);
```

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.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.ColorArray
========================

Type
----

Un tableau de quatre nombres entiers entre 0-255 définie une couleur RGBA. Les quatres couleurs spécifient les canaux suivants :

1. Rouge
2. Vert
3. Bleu
4. Alpha (opacité).

Par exemple , le rouge opaque est `[255, 0, 0, 255]`.

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.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.getTitle()
========================

Obtient le titre de l'action du navigateur.

Tout comme vous pouvez définir le titre par onglet en utilisant `browserAction.setTitle()`, vous pouvez donc récupérer un titre spécifique à un onglet en passant l'ID de l'onglet dans cette fonction.

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

Syntaxe
-------


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

### Paramètres

`details`

`object`

`tabId`Facultatif

`integer`. Spécifiez l'onglet pour obtenir le titre.

`windowId`Facultatif

`integer`. Spécifiez la fenêtre à partir de laquelle vous souhaitez obtenir le titre.



* Si `windowId` et `tabId` sont tous deux fournis, la fonction échoue et la promesse qu'elle renvoie est rejetée.
* Si `windowId` et `tabId` sont tous les deux omis, le titre global est renvoyé.
### Return value

Une `Promise` qui sera remplie avec une chaîne contenant le titre de l'action du navigateur.

Exemples
--------

Ce code change le titre entre "ceci" et "cela" chaque fois que l'utilisateur clique sur l'action du navigateur :


```js
function toggleTitle(title) {
  if (title == "this") {
    browser.browserAction.setTitle({ title: "that" });
  } else {
    browser.browserAction.setTitle({ title: "this" });
  }
}

browser.browserAction.onClicked.addListener(() => {
  var gettingTitle = browser.browserAction.getTitle({});
  gettingTitle.then(toggleTitle);
});
```

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.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.isEnabled()
=========================

Renvoie `true` si l'action du navigateur est activée.

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

Syntaxe
-------


```js
let gettingIsEnabled = browser.browserAction.isEnabled(
  details, // object
);
```

### Paramètres

`details`

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

`tabId` Facultatif

`integer`. ID d'un onglet à vérifier

`windowId` Facultatif

`integer`. ID d'une fenêtre à vérifier.



* Si windowId et tabId sont tous les deux fournis, la fonction échoue.
* Si windowId et tabId sont tous les deux omis, l'état global activé/désactivé est renvoyé.
### Valeur retournée

Une `Promise` qui sera remplie avec `true` si l'action du navigateur de l'extension est activée, et `false` dans le cas contraire.

Exemples
--------

Vérifiez l'état global :


```js
browser.browserAction.isEnabled({}).then((result) => {
  console.log(result);
});
```


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


```js
async function enabledInActiveTab() {
  let tabs = await browser.tabs.query({
    currentWindow: true,
    active: true,
  });
  let enabled = await browser.browserAction.isEnabled({
    tabId: tabs[0].id,
  });
  console.log(enabled);
}
```

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

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

Action quand l'icone d'action du navigateur est cliqué. Cet événement ne déclenchera pas si l'action du navigateur comporte une fenêtre contextuelle.

Pour définir une action de clic droit, utilisez l'API `contextMenus` avec le type de contexte "browser\_action".

Syntaxe
-------


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


Les événements ont trois fonctions :

`addListener(listener)`

Ajoutez un auditeur à cet événement.

`removeListener(listener)`

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

`hasListener(listener)`

Vérifier si l'autditeur est enregistré pour cet événement. Renvoie `true` si elle est écouté, sinon `false`.

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

### Paramètre

`callback`

Fonction de rappel qui sera appelée lorsque cet événement se produira. La fonction passera par l'argument suivant :

`tab`

`tabs.Tab`. L'onglet qui était actif lorsque l'icône 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'icône, désactivez-la pour l'onglet actif et enregistrez l'URL de l'onglet


```js
browser.browserAction.onClicked.addListener((tab) => {
  // disable the active tab
  browser.browserAction.disable(tab.id);
  // requires the "tabs" or "activeTab" permission
  console.log(tab.url);
});
```

### Example extensions

* bookmark-it
* favourite-colour
* find-across-tabs
* forget-it
* google-userinfo
* native-messaging
* open-my-page-button
* permissions
* runtime-examples
* store-collected-images

**Note :**

Cette API est basée sur l'API Chromium `chrome.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.getBadgeText()
============================

Obtient le texte du badge de l'action du navigateur.

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

Syntaxe
-------


```js
var gettingText = browser.browserAction.getBadgeText(
  details, // object
);
```

### Paramètres

`details`

`object`

`tabId`Facultatif

`integer`. Spécifie l'onglet pour obtenir le texte du badge.

`windowId`Facultatif

`integer`. Spécifie la fenêtre à partir de laquelle obtenir le texte du badge.



* Si windowId et tabId sont tous les deux fournis, la fonction échoue.
* Si windowId et tabId sont tous les deux omis, le texte global du badge est renvoyé.
### Valeur de retour

Une `Promise` qui sera remplie avec une chaîne contenant le texte du badge.

Exemples
--------

Enregistrez le texte du badge :


```js
function gotBadgeText(text) {
  console.log(text);
}

var gettingBadgeText = browser.browserAction.getBadgeText({});
gettingBadgeText.then(gotBadgeText);
```

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.browserAction`. Cette documentation est dérivée de `browser_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.
browserAction.openPopup()
=========================

Ouvrez le popup de l'action du navigateur.
Vous pouvez uniquement appeler cette fonction à partir du gestionnaire pour une action utilisateur.

Syntaxe
-------


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

### Paramètres

None.

### Valeur retournée

Une `Promise` cela est résolu 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.browserAction.openPopup();
});
```
browserAction.setBadgeTextColor()
=================================

Définit la couleur du texte du badge de l'action du navigateur. Les onglets sans couleur de texte de badge spécifique hériteront de la couleur globale du texte de badge.

Syntaxe
-------


```js
browser.browserAction.setBadgeTextColor(
  details, // object
);
```

### Paramètres

`details`

`object`

`color`

La couleur, spécifiée comme l'une des couleurs :

* une chaîne : toute valeur CSS <color>, par exemple `"red"`, `"#FF0000"`, ou `"rgb(255,0,0)"`. Si la chaîne n'est pas une couleur valide, la promesse retournée sera rejetée et la couleur du texte ne sera pas modifiée.
* Un objet ``browserAction.ColorArray``.
* `null`. Si un `tabId` est spécifié, il supprime la couleur du texte du badge spécifique à l'onglet afin que l'onglet hérite de la couleur globale du texte du badge. Dans le cas contraire, la couleur globale du texte du badge est ramenée à la valeur par défaut.

`tabId`Facultatif

`integer`. Définit la couleur du texte du badge uniquement pour l'onglet donné. La couleur est réinitialisée lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page.

`windowId`Facultatif

`integer`. Définit la couleur du texte du badge uniquement pour l'onglet donné.



* Si `windowId` et `tabId` sont tous deux fournis, la fonction échoue et la couleur n'est pas définie.
* Si `windowId` et `tabId` sont tous deux omis, la couleur globale du texte du badge est définie à la place.
Exemples
--------

Une couleur de texte de badge qui commence par le rouge et passe au vert lorsque l'on clique sur l'action du navigateur :


```js
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });

browser.browserAction.onClicked.addListener(() => {
  browser.browserAction.setBadgeTextColor({ color: "green" });
});
```


Définissez la couleur du texte du badge uniquement pour l'onglet actif :


```js
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });

browser.browserAction.onClicked.addListener((tab) => {
  browser.browserAction.setBadgeTextColor({
    color: "green",
    tabId: tab.id,
  });
});
```

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.browserAction`. Cette documentation est dérivée de `browser_action.json` dans le code de Chromium code.
browserAction.enable()
======================

Active l'action du navigateur pour un onglet. Par défaut, les actions du navigateur sont activées pour tous les onglets.

Syntaxe
-------


```js
browser.browserAction.enable(
  tabId, // optional integer
);
```

### Paramètres

`tabId`Facultatif

`integer`. L'identifiant (ID) de l'onglet pour lequel vous souhaitez activer l'action du navigateur.

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

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

Exemples
--------

Désactivez l'option du navigateur lorsque vous cliquez et réactivez-le chaque fois qu'un nouveau onglet est ouvert :


```js
browser.tabs.onCreated.addListener(() => {
  browser.browserAction.enable();
});

browser.browserAction.onClicked.addListener(() => {
  browser.browserAction.disable();
});
```


**Note :**

Cette API est basée sur l'API Chromium `chrome.browserAction`. Cette documentation est dérivée de `browser_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.