From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../add-ons/webextensions/api/tabs/hide/index.html | 88 ++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html') diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html new file mode 100644 index 0000000000..5fb1cf99f4 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html @@ -0,0 +1,88 @@ +--- +title: tabs.hide() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/hide +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - hide + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/hide +--- +
{{AddonSidebar()}}
+ +

Masque un ou plusieurs onglets.

+ +

Les onglets cachés ne sont plus visibles dans l'onglet du navigateur. Les onglets cachés ne sont pas automatiquement supprimés :  le code qui s'y trouve continue à s'exécuter. Vous pouvez explicitement supprimer les onglets à chaque fois que vous les masquez : bien que cela ne soit pas approprié dans toutes les situations, cela aidera à réduire les ressources utilisées par le navigateur.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Tous les onglets ne peuvent pas être masqués :

+ + + +

La première fois qu'une extension cache un onglet, le navigateur indiquera à l'utilisateur que l'onglet est caché, leur montrera comment ils peuvent accéder à l'onglet caché et leur donnera l'option de désactiver l'extension à la place.

+ +

Pour utiliser cette API, vous devez disposer de  la permission "tabHide".

+ +

Syntaxe

+ +
var hiding = browser.tabs.hide(
+  tabIds          // integer or integer array
+)
+
+ +

Paramètres

+ +
+
tabIds
+
integer or array of integer. Les ID de l'onglet ou des onglets à masquer.
+
Si l'un de ces onglets ne peut pas être masqué, il ne sera pas masqué, mais l'appel sera toujours valide et les onglets éligibles seront toujours masqués. Par exemple, si vous passez [1, 3], et 1 identifie l'onglet actif, alors seulement 3 seront cachés.
+
Cependant, si l'un des ID d'onglet n'est pas valide, l'appel échouera et aucun onglet ne sera masqué.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un tableau contenant les ID des onglets qui ont été cachés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Masquer un seul onglet :

+ +
function onHidden() {
+  console.log(`Hidden`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.tabs.hide(2).then(onHidden, onError);
+ +

Masquer plusieurs onglets :

+ +
function onHidden() {
+  console.log(`Hidden`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.tabs.hide([15, 14, 1]).then(onHidden, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.tabs.hide")}}

-- cgit v1.2.3-54-g00ecf