Rejette un ou plusieurs onglets.

Certains navigateurs "suppriment" automatiquement les onglets dont ils ne pensent pas qu'ils seront bientôt utiles à l'utilisateur. L'onglet reste visible dans la bande d'onglets et le navigateur se souvient de son état, donc si l'utilisateur sélectionne un onglet qui a été supprimé, il est immédiatement restauré.

Les détails de ce qui est supprimé sont spécifiques au navigateur, mais en général, l'abandon d'un onglet permet au navigateur de libérer une partie de la mémoire occupée par cet onglet.

L'API tabs.discard() permet à une extension d'ignorer un ou plusieurs onglets. Il n'est pas possible de supprimer l'onglet actuellement actif ou un onglet dont le document contient un programme d'écoute beforeunload qui afficherait une invite.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var discarding = browser.tabs.discard(
  tabIds          // integer or integer array
)

Paramètres

tabIds
integer or array of integer. Les ID de l'onglet ou des onglets à ignorer.

Valeur retournée

Une Promise qui sera remplie sans argument lorsque tous les onglets spécifiés ont été supprimés. Si une erreur se produit (par exemple, ID d'onglet non valide), la promesse sera rejetée avec un message d'erreur.

Si l'ID de l'onglet actif est transmis, il ne sera pas supprimé, mais la promesse sera satisfaite et tous les autres onglets transférés seront supprimés.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple541 2 3 4 Oui58 Non Oui1 2 3 4

1. Only accepts a single tab ID as a parameter, not an array.

2. The tab ID argument is optional: if it is omitted, the browser discards the least important tab.

3. The callback is passed a Tab object representing the tab that was discarded.

4. Tabs whose document contains a beforeunload listener that displays a prompt will be discarded.

Exemples

Supprimer un seul onglet :

function onDiscarded() {
  console.log(`Discarded`);
}

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

var discarding = browser.tabs.discard(2);
discarding.then(onDiscarded, onError);

Ignorer plusieurs onglets :

function onDiscarded() {
  console.log(`Discarded`);
}

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

var discarding = browser.tabs.discard([15, 14, 1]);
discarding.then(onDiscarded, onError);

Remerciements :

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

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,