recursal/MDN huggingface dataset:
events
======

Types communs utilisés par les API qui distribuent les événements.

Types
-----

`events.Rule`

Description d'une règle déclarative pour gérer les événements.

`events.Event`

Un objet qui permet l'ajout et la suppression d'écouteurs pour un événement Chrome.

`events.UrlFilter`

Filtre les URL pour différents critères. Si un critère donné correspond, alors tout le filtre correspond.

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

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.
browsingData
============

Permet aux extensions d'effacer les données accumulées pendant la navigation de l'utilisateur.

Dans l'API `browsingData`, les données de navigations sont divisées en types :

* cache du navigateur
* cookies
* Téléchargements
* historique
* stockage local
* données du plugin
* données de formulaire enregistrées
* Mots de passe enregistrés

Vous pouvez utiliser la fonction `browsingData.remove()` pour supprimer toute combinaison de ces types. Il existe également des fonctions dédiées pour supprimer chaque type particulier de données, comme `removePasswords()`, `removeHistory()` etc.

Toutes les fonctions `browsingData.remove[X]()` prennent un objet `browsingData.RemovalOptions` que vous pouvez utiliser pour contrôler deux autres aspects de la suppression des données :

* dans quelle mesure remonter dans le temps pour supprimer des données
* qu'il s'agisse de supprimer des données uniquement de pages Web normales ou d'applications Web hébergées et de modules complémentaires. Notez que cette option n'est pas encore supportée dans Firefox.

Enfin, cette API vous donne une fonction `browsingData.settings()` qui vous donne la valeur actuelle des paramètres de la fonction "Effacer l'historique" du navigateur.

Pour utiliser cette API, vous devez disposer de l'API permission "browseData".

Types
-----

`browsingData.DataTypeSet`

Objet utilisé pour spécifier le type de données à supprimer: par exemple, l'historique, les téléchargements, les mots de passe, etc.

`browsingData.RemovalOptions`

Objet utilisé pour spécifier le retour arrière des données, et la suppression des données ajoutées par le biais de la navigation Web normale, des applications hébergées ou des modules complémentaires.

Méthodes
--------

`browsingData.remove()`

Supprime les données de navigation pour les types de données spécifiés.

`browsingData.removeCache()`

Efface le cache du navigateur.

`browsingData.removeCookies()`

Supprime les cookies

`browsingData.removeDownloads()`

Supprime la liste des fichiers téléchargés.

`browsingData.removeFormData()`

Efface les données de formulaire enregistrées.

`browsingData.removeHistory()`

Efface l'historique du navigateur.

`browsingData.removeLocalStorage()`

Efface tout stockage local créé par des sites web.

`browsingData.removePasswords()`

Efface les mots de passe enregistrés.

`browsingData.removePluginData()`

Efface les données associées aux plugins.

`browsingData.settings()`

Obtient la valeur actuelle des paramètres dans la fonction "Effacer l'historique" du navigateur

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

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

Example extensions
------------------

* forget-it

**Note :**

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

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.
extension.getURL()
==================

**Attention :** Cette fonction est obsolète. Veuillez utiliser `runtime.getURL`.

Convertit un chemin relatif dans le répertoire d'installation d'une extension en une URL complète.

Syntaxe
-------


```js
browser.extension.getURL(
  path, // string
);
```

### Paramètres

`path`

`string`. Un chemin vers une ressource dans une extension exprimée par rapport à son répertoire d'installation.

### Valeur retournée

`string`. The fully-qualified URL to the resource.

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

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

Exemples
--------

Donné un fichier empaqueté avec l'add-on à "beasts/frog.html", obtenez l'URL complète comme ceci :


```js
var fullURL = browser.extension.getURL("beasts/frog.html");

// -> something like:
// moz-extension://2c127fa4-62c7-7e4f-90e5-472b45eecfdc/beasts/frog.html
```

### Example extensions

* beastify
* cookie-bg-picker
* imagify
* notify-link-clicks-i18n
* proxy-blocker

**Note :**

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

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.
extension.onRequest
===================

**Attention :** Ceci n'est pas implémenté dans Firefox car il est obsolète depuis Chrome 33. Veuillez utiliser runtime.onMessageExternal à la place.

Lancé lorsqu'une requête est envoyée par un processus d'extension ou un script de contenu.

Syntaxe
-------


```js
chrome.extension.onRequest.addListener(function(
  request,         // optional any
  sender,          // runtime.MessageSender
  function() {...} // function
) {...})
chrome.extension.onRequest.removeListener(listener)
chrome.extension.onRequest.hasListener(listener)
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

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

`hasListener(listener)`

Vérifiez si `listener` est enregistré pour cet événement. Renvoie `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 arguments suivants :

`request`

`any`. La requête envoyée par le script appelant.


`sender`

`runtime.MessageSender`.


`sendResponse`

`function`. Fonction à appeler (au plus une fois) lorsque vous avez une réponse. L'argument doit être n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de réponse. Si vous avez plus d'un écouteur `onRequest` dans le même document, un seul peut envoyer une réponse.


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

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.
extension.getBackgroundPage()
=============================

Alias de `runtime.getBackgroundPage()`.

**Note :** Cette méthode ne peut pas être utilisée en mode Navigation privée - elle renvoie toujours un tableau vide. Pour plus d'informations, voir le bug Firefox 1329304.

Syntaxe
-------


```js
var page = browser.extension.getBackgroundPage();
```

### Paramètres

Aucun

### Valeur retournée

`object`. Window de la page d'arrière plan.

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

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

Exemples
--------

Supposons un script d'arrière plan définisse une fonction `foo()`:


```js
// background.js

function foo() {
  console.log("I'm defined in background.js");
}
```


Un script exécuté dans un popup peut appeler cette fonction directement comme ceci :


```js
// popup.js

var page = browser.extension.getBackgroundPage();
page.foo(); // -> "I'm defined in background.js"
```

### Example extensions

* find-across-tabs
* user-agent-rewriter

**Note :**

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

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.
extension.isAllowedFileSchemeAccess()
=====================================

Renvoie `true` si l'extension peut accéder au schéma "file://", sinon `false`.
C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
var isAllowed = browser.extension.isAllowedFileSchemeAccess();
```

### Paramètres

None.

### Valeur retournée

Une `Promise` qui sera remplie avec un booléen : `true` si l'extension est autorisée à accéder aux URLs "file://", sinon `false`.

Firefox retournera toujours `false`.

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

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

Exemples
--------


```js
function logIsAllowed(answer) {
  console.log(`Is allowed: ${answer}`);
}

var isAllowed = browser.extension.isAllowedFileSchemeAccess();
isAllowed.then(logIsAllowed);
```


**Note :**

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

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.
extension.ViewType
==================

Le type de vue de l'extension.

Type
----

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont : `"tab"`, `"popup"`, `"sidebar"`.

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

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.
extension.getViews()
====================

Renvoie un tableau des objets Window pour chacune des pages exécutées dans l'extension en cours. Cela inclut, par exemple :

* la page d'arrière-plan, si une est définie
* toutes les pages contextuelles, si définies et chargées
* toutes les pages d'options, si définies et chargées
* les onglets du navigateur hébergeant le contenu fourni avec l'extension

Dans Firefox, si cette méthode est appelée à partir d'une page faisant partie d'une fenêtre de navigation privée, telle qu'une barre latérale dans une fenêtre privée ou une fenêtre ouverte à partir d'une fenêtre privée, sa valeur de retour n'inclut pas la page d'arrière-plan de l'extension.

Syntaxe
-------


```js
var windows = browser.extension.getViews(
  fetchProperties, // optional object
);
```

### Paramètres

`fetchProperties`Facultatif

`object`.

`type`Facultatif

`string`. Un `extension.ViewType` indiquant le type de vue à obtenir. Si omis, cette fonction renvoie toutes les vues.

`windowId`Facultatif

`integer`. La fenêtre pour restreindre la recherche. Si omis, cette fonction renvoie toutes les vues.


### Valeur retournée

`array` of `object`. Un tableau d'objets Window.

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

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

Exemples
--------

Obtenez toutes les fenêtres appartenant à cette extension et consignez leurs URL :


```js
var windows = browser.extension.getViews();

for (var extensionWindow of windows) {
  console.log(extensionWindow.location.href);
}
```


Obtenez uniquement des fenêtres dans les onglets du navigateur hébergeant du contenu fourni avec l'extension :


```js
var windows = browser.extension.getViews({ type: "tab" });
```


Obtenir seulement des fenêtres dans les popups :


```js
var windows = browser.extension.getViews({ type: "popup" });
```


**Note :**

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

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.
extension.onRequestExternal
===========================

**Attention :** Ceci n'est pas implémenté dans Firefox car il est obsolète depuis Chrome 33. Veuillez utiliser runtime.onMessageExternal à la place.

Lancé lorsqu'une requête est envoyée depuis une autre extension.

Syntaxe
-------


```js
chrome.extension.onRequestExternal.addListener(function(
  request,         // optional any
  sender,          // runtime.MessageSender
  function() {...} // function
) {...})
chrome.extension.onRequestExternal.removeListener(listener)
chrome.extension.onRequestExternal.hasListener(listener)
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

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

`hasListener(listener)`

Vérifiez si `listener` est enregistré pour cet événement. Renvoie `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 arguments suivants :

`request`

`any`. La requête envoyée par le script appelant.


`sender`

`runtime.MessageSender`.


`sendResponse`

`function`. Fonction à appeler lorsque vous avez une réponse. L'argument doit être n'importe quel objet JSON-ifiable, ou undefined s'il n'y a pas de réponse.


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

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.
extension.isAllowedIncognitoAccess()
====================================

Vérifiez si l'extension est autorisée à accéder aux onglets ouverts en mode "navigation privée".

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

Syntaxe
-------


```js
var isAllowed = browser.extension.isAllowedIncognitoAccess();
```

### Paramètres

None.

### Valeur retournée

Une `Promise` qui sera remplie avec un booléen : `true` si l'extension est autorisée à accéder aux onglets privés, sinon `false`.

Exemples
--------


```js
function logIsAllowed(answer) {
  console.log(`Is allowed: ${answer}`);
}

var isAllowed = browser.extension.isAllowedIncognitoAccess();
isAllowed.then(logIsAllowed);
```

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

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.
extension.getExtensionTabs()
============================

**Attention :** Cette méthode a été dépréciée. Utilisez `extension.getViews()` à la place.

Renvoie un tableau des objets de la Window JavaScriptpour chacun des onglets qui s'exécutent dans l'extension actuelle. Si `windowId` est spécifié, renvoie uniquement les objets Window des onglets attachés à la fenêtre spécifiée.

Syntaxe
-------


```js
chrome.extension.getExtensionTabs(
  windowId, // optional integer
);
```


Cette API est également disponible en tant que `browser.extension.getExtensionTabs()`.

### Paramètres

`windowId`Facultatif

`integer`.

### Valeur retournée

`array` of `object`. Tableau d'objets de fenêtre globaux

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

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.
extension.inIncognitoContext
============================

Valeur booléenne, `true` pour les scripts de contenu s'exécutant dans les onglets de navigation privée et pour les pages d'extension exécutées dans un processus de navigation privé..

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

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.
extension.sendRequest()
=======================

**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.

**Attention :** Cette méthode est dépréciée. utilisez `runtime.sendMessage` à la place.

Envoie une seule requête aux autres écouteurs de l'extension. Similaire à `runtime.connect`,mais envoie seulement une seule requête avec une réponse optionnelle. L'événement `extension.onRequest` est déclenché dans chaque page de l'extension

Syntaxe
-------


```js
chrome.extension.sendRequest(
  extensionId,             // optional string
  request,                 // any
  function(response) {...} // optional function
)
```


Cette API est également disponible en tant que `browser.extension.sendRequest()` dans une version qui renvoie une promise.

### Paramètres

`extensionId`Facultatif

`string`. L'ID d'extension de l'extension à laquelle vous souhaitez vous connecter. Si omis, la valeur par défaut est votre propre extension.

`request`

`any`.

`responseCallback`Facultatif

`function`. La fonction est passée les arguments suivants :

`response`

`any`. Objet de réponse JSON envoyé par le gestionnaire de la requête. Si une erreur survient lors de la connexion à l'extension, le rappel sera appelé sans arguments et `runtime.lastError` sera défini sur le message d'erreur.


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

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.
extension.setUpdateUrlData()
============================

Définit les paramètres de l'URL de mise à jour de l'extension. Cette valeur est ignorée pour les extensions hébergées dans le magasin du fournisseur du navigateur.

Syntaxe
-------


```js
browser.extension.setUpdateUrlData(
  data, // string
);
```

### Paramètres

`data`

`string`.

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

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

Exemples
--------

**Note :**

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

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.
extension.lastError
===================

Un alias de `runtime.lastError`.

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

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.
omnibox.OnInputEnteredDisposition
=================================

Le type **`omnibox.OnInputEnteredDisposition`** décrit comment l'extension doit gérer une sélection d'utilisateur à partir des suggestions dans la liste déroulante de la barre d'adresse.

Il est passé dans l'écouteur `omnibox.onInputEntered` avec la sélection elle-même.

Type
----

Les valeurs de ce type sont des chaînes. Ils peuvent prendre l'une des valeurs suivantes :

"currentTab"

Ouvrez la sélection dans l'onglet actuel.

"newForegroundTab"

Ouvrez la sélection dans un nouvel onglet et placez ce nouvel onglet au premier plan.

"newBackgroundTab"

Ouvrez la sélection dans un nouvel onglet d'arrière-plan, en conservant l'onglet en cours au premier plan.

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.omnibox`.

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.
omnibox.onInputStarted
======================

Lancé lorsque l'utilisateur commence à interagir avec votre extension en entrant son mot-clé dans la barre d'adresse, puis en appuyant sur la touche espace.

Cela sera envoyé avant tout événement `omnibox.onInputChanged` events.

Syntaxe
-------


```js
browser.omnibox.onInputStarted.addListener(listener);
browser.omnibox.onInputStarted.removeListener(listener);
browser.omnibox.onInputStarted.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

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

`hasListener(listener)`

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

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

### Paramètres

`callback`

Fonction qui sera appelée lorsque cet événement se produit. La fonction sera passée sans arguments.

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

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

Exemples
--------


```js
browser.omnibox.onInputStarted.addListener(() => {
  console.log("User has started interacting with me.");
});
```


**Note :**

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

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.