recursal/MDN huggingface dataset:
runtime.onSuspend
=================

Envoyé sur la page de l'événement juste avant son déchargement. Cela donne à l'extension l'opportunité de faire un peu de nettoyage. Notez que, comme la page est en cours de déchargement, les opérations asynchrones démarrées lors de la gestion de cet événement ne sont pas garanties.

**Note :** Si quelque chose empêche le déchargement de la page d'événement, l'événement `runtime.onSuspendCanceled` sera envoyé et la page ne sera pas déchargée.

Syntaxe
-------


```js
browser.runtime.onSuspend.addListener(listener);
browser.runtime.onSuspend.removeListener(listener);
browser.runtime.onSuspend.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érifie si un `écouteur` est enregistré pour cet événement. Retourne `true` s'il est écouté, sinon `false`.

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

### Paramètres

`callback`

Fonction dui sera appelée lorsque cet événement se produit

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

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

Exemples
--------

Ecoutez les événements suspendus :


```js
function handleSuspend() {
  console.log("Suspending event page");
  // handle cleanup
}

browser.runtime.onSuspend.addListener(handleSuspend);
```


**Note :**

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

Recharge une extension.

S'il y a des mises à jour en attente pour l'extension, qu'elles ont été différées en écoutant `runtime.onUpdateAvailable`, elles seront appliquées en reload.

Syntaxe
-------


```js
browser.runtime.reload();
```

### Paramètres

Aucun.

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

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

Exemples
--------

Rechargez l'extension lorsque l'utilisateur clique sur l'icône d'une action du navigateur :


```js
browser.browserAction.onClicked.addListener((tab) => {
  browser.runtime.reload();
});
```

### Example extensions

* runtime-examples

**Note :**

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

Obtenez le fichier manifest.json complet, sérialisé à un objet JSON.Syntaxe
-------


```js
browser.runtime.getManifest();
```

### Paramètres

None.

### Valeur retournée

Un `object` JSON représentant le manifest.

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

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

Exemples
--------

Récupère le manifest et consignez la propriété "name" :


```js
var manifest = browser.runtime.getManifest();
console.log(manifest.name);
```

### Example extensions

* runtime-examples

**Note :**

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

Renvoie un objet `DirectoryEntry` représentant le répertoire du package.

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

Syntaxe
-------


```js
var gettingEntry = browser.runtime.getPackageDirectoryEntry();
```

### Paramètres

None.

### Valeur retournée

Une `Promise` qui sera remplie avec un objet `DirectoryEntry` représentant le répertoire du package.

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

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

Exemples
--------


```js
function gotDirectoryEntry(directoryEntry) {
  console.log(directoryEntry);
}

var gettingEntry = browser.runtime.getPackageDirectoryEntry();
gettingEntry.then(gotDirectoryEntry);
```


**Note :**

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

Définit l'URL à visiter lorsque l'extension est déinstallée. Cela peut être utilisé pour nettoyer les données côté serveur, effectuer des analyses ou implémenter des enquêtes. L'URL peut contenir au maximum 255 caractères.

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

Syntaxe
-------


```js
var settingUrl = browser.runtime.setUninstallURL(
  url, // string
);
```

### Paramètres

`url`

`string`. L'URL à ouvrir après la désinstallation de l'extension. Cette URL doit avoir un schéma `http` ou `https`. Définissez-le sur une chaîne vide pour ne pas ouvrir un nouvel onglet lors de la désinstallation.

### Valeur retournée

Une `Promise` qui sera remplie sans argument lorsque l'URL a été définie ou rejetée avec un message d'erreur si l'opération a échoué.

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

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

Exemples
--------


```js
function onSetURL() {
  console.log("set uninstall URL");
}

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

var settingUrl = browser.runtime.setUninstallURL("https://example.org");
settingUrl.then(onSetURL, onError);
```


**Note :**

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

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

Lancé lorsqu'une mise à jour pour le navigateur est disponible, mais qu'elle n'est pas installée immédiatement car un redémarrage du navigateur est requi.

Syntaxe
-------


```js
browser.runtime.onBrowserUpdateAvailable.addListener(listener);
browser.runtime.onBrowserUpdateAvailable.removeListener(listener);
browser.runtime.onBrowserUpdateAvailable.hasListener(listener);
```


Les événements ont trois fonctions :

`addListener(callback)`

Ajoute un écouteur à cet événement.

`removeListener(listener)`

Arrestez d'écouter un événement. L'argument `listener` est l'écouteur à supprimer.

`hasListener(listener)`

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

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

### Paramètres

`function`

Une fonction de rappel qui sera appelée lorsque cet événement se produira.

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

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

Exemples
--------

Ecoutez cet événement :


```js
function handleBrowserUpdateAvailable() {
  // handle event
}

browser.runtime.onBrowserUpdateAvailable.addListener(
  handleBrowserUpdateAvailable,
);
```


**Note :**

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

Lancé lorsqu'une extension reçoit une demande de connexion d'une extension différente.

Pour envoyer un message qui sera reçu par le programme d'écoute `onConnectExternal`, utilisez `runtime.connect()`, en transmettant l'ID du destinataire dans le paramètre `extensionId`.

L'écouteur reçoit un objet `runtime.Port` qu'il peut ensuite utiliser pour envoyer et recevoir des messages. L'objet `Port` contient également une propriété`sender`, qui est un objet `runtime.MessageSender`, et que le destinataire peut utiliser pour vérifier l'ID de l'expéditeur.

Syntaxe
-------


```js
browser.runtime.onConnectExternal.addListener(listener);
browser.runtime.onConnectExternal.removeListener(listener);
browser.runtime.onConnectExternal.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érifie si un `listener` est enregistré pour cet événement. Retourne `true` s'il écoute, `false` sinon.

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

### Paramètres

`fonction`

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

`port`

Un objet `runtime.Port` connectant le script en cours à l'autre extension à laquelle il se connecte.


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

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

Exemples
--------

Dans cet exemple, l'extension Hansel se connecte à l'extension Gretel :


```js
console.log("connecting to Gretel");
var myPort = browser.runtime.connect("gretel@mozilla.org");

myPort.onMessage.addListener((message) => {
  console.log(`From Gretel: ${message.content}`);
});

browser.browserAction.onClicked.addListener(() => {
  myPort.postMessage({ content: "Hello from Hansel" });
});
```


Gretel écoute la connexion et vérifie que l'expéditeur est vraiment Hansel:


```js
var portFromHansel;

browser.runtime.onConnectExternal.addListener((port) => {
  console.log(port);
  if (port.sender.id === "hansel@mozilla.org") {
    console.log("connection attempt from Hansel");
    portFromHansel = port;
    portFromHansel.onMessage.addListener((message) => {
      console.log(`From Hansel: ${message.content}`);
    });
  }
});

browser.browserAction.onClicked.addListener(() => {
  portFromHansel.postMessage({ content: "Message from Gretel" });
});
```


**Note :**

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

L'architecture du processeur de la machine.

Type
----

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

`"arm"`

La plateforme est basée sur l'architecture des bras.

`"x86-32"`

La plateforme est basé sur l'architecture x86 32-bits.

`"x86-64"`

La plateforme est basé sur l'architecture x86 64-bits.

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.runtime`. Cette documentation est dérivée de `runtime.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.
bookmarks.onChanged
===================

Mise en place quand il y a un changement à :

* le titre ou l'URL d'un signet
* le nom d'un dossier.
Syntaxe
-------


```js
browser.bookmarks.onChanged.addListener(listener);
browser.bookmarks.onChanged.removeListener(listener);
browser.bookmarks.onChanged.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 :

`id`

`string`. ID de l'article qui a changé.


`changeInfo`

`object`. Objet contenant deux propriétés : `title`, une chaîne contenant le titre de l'élément et `url`, une chaîne contenant l'URL de l'élément. Si l'élément est un dossier, l'`url` est omise.


**Note :** Plusieurs événements peuvent se produire lorsqu'un signet change, et cet objet changeInfo peut contenir uniquement les données qui ont changé, plutôt que toutes les données du signet. En d'autres termes, si l'`url` d'un signet change, le changeInfo ne peut contenir que les nouvelles informations de l'`url`.

Exemples
--------


```js
function handleChanged(id, changeInfo) {
  console.log("Item: " + id + " changed");
  console.log("Title: " + changeInfo.title);
  console.log("Url: " + changeInfo.url);
}

function handleClick() {
  browser.bookmarks.onChanged.addListener(handleChanged);
}

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

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.bookmarks`. Cette documentation provient de `bookmarks.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.
bookmarks.onImportEnded
=======================

Lancé lorsque le navigateur a fini d'importer un ensemble de signets.

Voir `bookmarks.onImportBegan`.

Syntaxe
-------


```js
browser.bookmarks.onImportEnded.addListener(listener);
browser.bookmarks.onImportEnded.removeListener(listener);
browser.bookmarks.onImportEnded.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. Il n'a pas passé de paramètres.

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

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

Exemples
--------


```js
function handleImportBegan() {
  console.log("Importing...");
}

function handleImportEnded() {
  console.log("...finished.");
}

function handleClick() {
  browser.bookmarks.onImportBegan.addListener(handleImportBegan);
  browser.bookmarks.onImportEnded.addListener(handleImportEnded);
}

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


**Note :**

Cette API est basée sur l'API Chromium `chrome.bookmarks`. Cette documentation provient de `bookmarks.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.
bookmarks.onMoved
=================

Lancé lorsqu'un signet ou un dossier est déplacé vers un autre dossier parent et / ou position dans un dossier.

Syntaxe
-------


```js
browser.bookmarks.onMoved.addListener(listener);
browser.bookmarks.onMoved.removeListener(listener);
browser.bookmarks.onMoved.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
-------------------

### Parameters

`callback`

Function that will be called when this event occurs. The function will be passed the following arguments:

`id`

`string`. ID of the item that was moved.


`moveInfo`

`object`. Object containing more details about the move.


Objets supplémentaires
----------------------

### moveInfo

`parentId`

`string`. Le nouveau dossier parent.

`index`

`integer`. Le nouvel index de cet élément dans son parent.

`oldParentId`

`string`. L'ancien dossier parent.

`oldIndex`

`integer`. L'ancien index de l'élément dans son parent.

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

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

Exemples
--------


```js
function handleMoved(id, moveInfo) {
  console.log("Item: " + id + " moved");
  console.log("Old index: " + moveInfo.oldIndex);
  console.log("New index: " + moveInfo.index);
  console.log("Old folder: " + moveInfo.oldParentId);
  console.log("New folder: " + moveInfo.parentId);
}

function handleClick() {
  browser.bookmarks.onMoved.addListener(handleMoved);
}

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


**Note :**

Cette API est basée sur l'API Chromium `chrome.bookmarks`. Cette documentation provient de `bookmarks.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.
bookmarks.move()
================

La méthode **`bookmarks.move()`** déplace le `BookmarkTreeNode` à la destination spécifiée dans l'arborescence des signets. Cela vous permet de déplacer un signet vers un nouveau dossier et / ou une position dans le dossier.

**Attention :** Si votre extension tente de déplacer un signet dans le nœud racine de l'arborescence de signets, l'appel déclenche une erreur avec le message suivant: "*La racine du signet ne peut pas être modifiée*" et le déplacement ne sera pas terminé.

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

Syntaxe
-------


```js
var movingBookmark = browser.bookmarks.move(
  id, // string
  destination, // object
);
```

### Paramètres

`id`

Un `string` contenant l'ID du signet ou du dossier à déplacer.

`destination`

Un `object` qui spécifie la destination du signet. Cet objet doit contenir un ou les deux champs suivants :

`parentId` Facultatif

Un `string` qui spécifie l'ID du dossier de destination. Si cette valeur est omise, le signet est déplacé vers un nouvel emplacement dans son dossier actuel.

`index` Facultatif

Un index basé sur 0 spécifiant la position dans le dossier vers lequel déplacer le signet. La valeur 0 déplace le signet vers le haut du dossier. Si cette valeur est omise, le signet est placé à la fin du nouveau dossier parent..


### Valeur retournée

Une `Promise` qui sera remplie avec un seul objet `bookmarks.BookmarkTreeNode` décrivant le noeud déplacé.Si le noeud correspondant au paramètre `id` ne peut pas être trouvé, la promesse est rejetée avec un message d'erreur.

Exemples
--------

Cet exemple déplace un signet afin qu'il soit le premier signet dans son dossier actuel.


```js
function onMoved(bookmarkItem) {
  console.log(bookmarkItem.index);
}

function onRejected(error) {
  console.log(`An error: ${error}`);
}

var bookmarkId = "abcdefghilkl";

var movingBookmark = browser.bookmarks.move(bookmarkId, { index: 0 });
movingBookmark.then(onMoved, onRejected);
```

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.bookmarks`. Cette documentation provient de `bookmarks.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.
bookmarks.onImportBegan
=======================

Lancé lorsque le navigateur a commencé à importer un ensemble de signet.

Pendant l'importation d'un ensemble de signets, `onCreated` peut déclencher plusieurs fois. Si votre extension écoute `onCreated`, et que l'écouteur est cher, vous devez également écouter `onImportBegan` et `onImportEnded`. Lorsque vous recevez `onImportBegan`, ignorez `onCreated` jusqu'à ce que vous receviez `onImportEnded`. Vous pouvez gérer toutes les autres notifications comme d'habitude.

Syntaxe
-------


```js
browser.bookmarks.onImportBegan.addListener(listener);
browser.bookmarks.onImportBegan.removeListener(listener);
browser.bookmarks.onImportBegan.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
-------------------

### Parameters

`callback`

Fonction qui sera appelée lorsque cet événement se produit. Il n'y a pas de paramètres.

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

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

Exemples
--------


```js
function handleImportBegan() {
  console.log("Importing...");
}

function handleImportEnded() {
  console.log("...finished.");
}

function handleClick() {
  browser.bookmarks.onImportBegan.addListener(handleImportBegan);
  browser.bookmarks.onImportEnded.addListener(handleImportEnded);
}

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


**Note :**

Cette API est basée sur l'API Chromium `chrome.bookmarks`. Cette documentation provient de `bookmarks.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.