From c0c9e75f6d17feb745be594dab11bc2fec0cf2bd Mon Sep 17 00:00:00 2001 From: Mélanie Chauvel Date: Fri, 16 Jul 2021 19:09:59 +0200 Subject: [fr] update WebExtensions API tabs.duplicate page (#1566) * [fr] update WebExtensions API tabs.duplicate page * Review PR 1566 - minor rewordings and updating/removing macros according to recent practices Co-authored-by: SphinxKnight --- .../webextensions/api/tabs/duplicate/index.html | 75 ++++++++++++---------- 1 file changed, 42 insertions(+), 33 deletions(-) diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html index 51088cd03e..ba2bc4cd4c 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html @@ -1,79 +1,88 @@ --- title: tabs.duplicate() slug: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate -tags: - - API - - Add-ons - - Duplicate - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - onglets - - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate +browser-compat: webextensions.api.tabs.duplicate ---
{{AddonSidebar()}}
-

Duplique un onglet dont l’identifiant est donné.

+

Duplique un onglet dont l'identifiant est donné.

-

C'est une fonction asynchrone qui renvoie une Promise.

+

Il s'agit d'une fonction asynchrone qui renvoie une promesse (Promise).

-

Syntaxe

+

Syntaxe

-
var duplicating = browser.tabs.duplicate(
-  tabId              // integer
-)
+
+let duplicating = browser.tabs.duplicate(
+  tabId,              // entier
+  duplicateProperties // objet optionnel
+);
 

 
-
Paramètres

+
Paramètres

 
 

  
tabId

  
integer. L'identifiant de l'onglet à dupliquer.

+ 
duplicateProperties Optionnel

+ 
object. Un objet décrivant la façon dont l'onglet est dupliqué. Il contient les propriétés suivantes :

+ 

+ 

+  
index Optionnel

+  
integer. La position du nouvel onglet dans la fenêtre. La valeur est restreinte à l'intervalle entre zéro et le nombre d'onglets dans la fenêtre.

+  
active Optionnel

+  

+  
boolean. Si l'onglet devient l'onglet actif dans la fenêtre. Cela ne change pas l'état du focus pour la fenêtre. true par défaut.

+  

+ 

+ 

 

 
-
valeur retournée

+
Valeur de retour

 
-
Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des détails sur l'onglet dupliqué. L'objet onglet contient uniquement url, title et favIconUrl si l'extension a la  permission "tabs". Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+
Une promesse (Promise) dont la valeur de résolution sera un objet tabs.Tab contenant des détails sur l'onglet dupliqué. L'objet Tab contiendra les propriétés url, title et favIconUrl uniquement si l'extension dispose de la  permission "tabs" ou lorsque l'hôte correspond à un hôte ciblé dans les permissions. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

 
-

-
Note: A partir de Firefox 68, la promise retournée par browser.tabs.duplicate() se résout dès que l'onglet a été dupliqué. Auparavant, la promise n'était résolue qu'une fois l'onglet entièrement chargé.

+

+
Note : À partir de Firefox 68, la promesse renvoyée par browser.tabs.duplicate() se résout dès que l'onglet a été dupliqué. Auparavant, la promesse n'était résolue qu'une fois l'onglet entièrement chargé.

 

 
 
Exemples

 
-
Duplique le premier onglet, puis affiche l'ID de l'onglet nouvellement créé :

+
Duplique le premier onglet, puis affiche l'identifiant de l'onglet nouvellement créé :

 
-
function onDuplicated(tabInfo) {
+
+function onDuplicated(tabInfo) {
   console.log(tabInfo.id);
 }
 
 function onError(error) {
-  console.log(`Error: ${error}`);
+  console.error(error);
 }
 
-// Duplicate the first tab in the array
+// Duplique le premier onglet du tableau
 function duplicateFirstTab(tabs) {
   console.log(tabs);
   if (tabs.length > 0) {
-    var duplicating = browser.tabs.duplicate(tabs[0].id);
+    let duplicating = browser.tabs.duplicate(tabs[0].id);
     duplicating.then(onDuplicated, onError);
   }
 }
 
-// Query for all open tabs
-var querying = browser.tabs.query({});
+// On récupère tous les onglets ouverts
+let querying = browser.tabs.query({});
 querying.then(duplicateFirstTab, onError);

 
-
{{WebExtExamples}}

+
Exemple d'extensions

 
-
Compatibilité du navigateur

+
 
-
{{Compat("webextensions.api.tabs.duplicate")}}

+
Compatibilité des navigateurs

 
-
Remerciements :
+
{{Compat}}

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

 
-- 
cgit v1.2.3-54-g00ecf