From f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:09 +0100 Subject: move *.html to *.md --- .../webextensions/api/tabs/capturetab/index.html | 100 -------- .../webextensions/api/tabs/capturetab/index.md | 100 ++++++++ .../api/tabs/capturevisibletab/index.html | 103 -------- .../api/tabs/capturevisibletab/index.md | 103 ++++++++ .../webextensions/api/tabs/connect/index.html | 120 --------- .../webextensions/api/tabs/connect/index.md | 120 +++++++++ .../webextensions/api/tabs/create/index.html | 137 ----------- .../add-ons/webextensions/api/tabs/create/index.md | 137 +++++++++++ .../api/tabs/detectlanguage/index.html | 127 ---------- .../webextensions/api/tabs/detectlanguage/index.md | 127 ++++++++++ .../webextensions/api/tabs/discard/index.html | 113 --------- .../webextensions/api/tabs/discard/index.md | 113 +++++++++ .../webextensions/api/tabs/duplicate/index.html | 120 --------- .../webextensions/api/tabs/duplicate/index.md | 120 +++++++++ .../api/tabs/executescript/index.html | 173 ------------- .../webextensions/api/tabs/executescript/index.md | 173 +++++++++++++ .../add-ons/webextensions/api/tabs/get/index.html | 95 ------- .../add-ons/webextensions/api/tabs/get/index.md | 95 +++++++ .../api/tabs/getallinwindow/index.html | 88 ------- .../webextensions/api/tabs/getallinwindow/index.md | 88 +++++++ .../webextensions/api/tabs/getcurrent/index.html | 94 ------- .../webextensions/api/tabs/getcurrent/index.md | 94 +++++++ .../webextensions/api/tabs/getselected/index.html | 87 ------- .../webextensions/api/tabs/getselected/index.md | 87 +++++++ .../webextensions/api/tabs/getzoom/index.html | 110 --------- .../webextensions/api/tabs/getzoom/index.md | 110 +++++++++ .../api/tabs/getzoomsettings/index.html | 97 -------- .../api/tabs/getzoomsettings/index.md | 97 ++++++++ .../webextensions/api/tabs/goback/index.html | 101 -------- .../add-ons/webextensions/api/tabs/goback/index.md | 101 ++++++++ .../webextensions/api/tabs/goforward/index.html | 101 -------- .../webextensions/api/tabs/goforward/index.md | 101 ++++++++ .../add-ons/webextensions/api/tabs/hide/index.html | 87 ------- .../add-ons/webextensions/api/tabs/hide/index.md | 87 +++++++ .../webextensions/api/tabs/highlight/index.html | 99 -------- .../webextensions/api/tabs/highlight/index.md | 99 ++++++++ .../add-ons/webextensions/api/tabs/index.html | 223 ----------------- .../add-ons/webextensions/api/tabs/index.md | 223 +++++++++++++++++ .../webextensions/api/tabs/insertcss/index.html | 141 ----------- .../webextensions/api/tabs/insertcss/index.md | 141 +++++++++++ .../add-ons/webextensions/api/tabs/move/index.html | 166 ------------- .../add-ons/webextensions/api/tabs/move/index.md | 166 +++++++++++++ .../api/tabs/moveinsuccession/index.html | 51 ---- .../api/tabs/moveinsuccession/index.md | 51 ++++ .../webextensions/api/tabs/mutedinfo/index.html | 75 ------ .../webextensions/api/tabs/mutedinfo/index.md | 75 ++++++ .../api/tabs/mutedinforeason/index.html | 75 ------ .../api/tabs/mutedinforeason/index.md | 75 ++++++ .../webextensions/api/tabs/onactivated/index.html | 118 --------- .../webextensions/api/tabs/onactivated/index.md | 118 +++++++++ .../api/tabs/onactivechanged/index.html | 118 --------- .../api/tabs/onactivechanged/index.md | 118 +++++++++ .../webextensions/api/tabs/onattached/index.html | 124 ---------- .../webextensions/api/tabs/onattached/index.md | 124 ++++++++++ .../webextensions/api/tabs/oncreated/index.html | 108 -------- .../webextensions/api/tabs/oncreated/index.md | 108 ++++++++ .../webextensions/api/tabs/ondetached/index.html | 124 ---------- .../webextensions/api/tabs/ondetached/index.md | 124 ++++++++++ .../api/tabs/onhighlightchanged/index.html | 111 --------- .../api/tabs/onhighlightchanged/index.md | 111 +++++++++ .../api/tabs/onhighlighted/index.html | 117 --------- .../webextensions/api/tabs/onhighlighted/index.md | 117 +++++++++ .../webextensions/api/tabs/onmoved/index.html | 131 ---------- .../webextensions/api/tabs/onmoved/index.md | 131 ++++++++++ .../webextensions/api/tabs/onremoved/index.html | 127 ---------- .../webextensions/api/tabs/onremoved/index.md | 127 ++++++++++ .../webextensions/api/tabs/onreplaced/index.html | 117 --------- .../webextensions/api/tabs/onreplaced/index.md | 117 +++++++++ .../api/tabs/onselectionchanged/index.html | 115 --------- .../api/tabs/onselectionchanged/index.md | 115 +++++++++ .../webextensions/api/tabs/onupdated/index.html | 272 --------------------- .../webextensions/api/tabs/onupdated/index.md | 272 +++++++++++++++++++++ .../webextensions/api/tabs/onzoomchange/index.html | 126 ---------- .../webextensions/api/tabs/onzoomchange/index.md | 126 ++++++++++ .../webextensions/api/tabs/pagesettings/index.html | 86 ------- .../webextensions/api/tabs/pagesettings/index.md | 86 +++++++ .../webextensions/api/tabs/print/index.html | 46 ---- .../add-ons/webextensions/api/tabs/print/index.md | 46 ++++ .../webextensions/api/tabs/printpreview/index.html | 62 ----- .../webextensions/api/tabs/printpreview/index.md | 62 +++++ .../webextensions/api/tabs/query/index.html | 187 -------------- .../add-ons/webextensions/api/tabs/query/index.md | 187 ++++++++++++++ .../webextensions/api/tabs/reload/index.html | 113 --------- .../add-ons/webextensions/api/tabs/reload/index.md | 113 +++++++++ .../webextensions/api/tabs/remove/index.html | 110 --------- .../add-ons/webextensions/api/tabs/remove/index.md | 110 +++++++++ .../webextensions/api/tabs/removecss/index.html | 119 --------- .../webextensions/api/tabs/removecss/index.md | 119 +++++++++ .../webextensions/api/tabs/saveaspdf/index.html | 60 ----- .../webextensions/api/tabs/saveaspdf/index.md | 60 +++++ .../webextensions/api/tabs/sendmessage/index.html | 145 ----------- .../webextensions/api/tabs/sendmessage/index.md | 145 +++++++++++ .../webextensions/api/tabs/sendrequest/index.html | 87 ------- .../webextensions/api/tabs/sendrequest/index.md | 87 +++++++ .../webextensions/api/tabs/setzoom/index.html | 105 -------- .../webextensions/api/tabs/setzoom/index.md | 105 ++++++++ .../api/tabs/setzoomsettings/index.html | 100 -------- .../api/tabs/setzoomsettings/index.md | 100 ++++++++ .../add-ons/webextensions/api/tabs/show/index.html | 69 ------ .../add-ons/webextensions/api/tabs/show/index.md | 69 ++++++ .../add-ons/webextensions/api/tabs/tab/index.html | 125 ---------- .../add-ons/webextensions/api/tabs/tab/index.md | 125 ++++++++++ .../webextensions/api/tabs/tab_id_none/index.html | 62 ----- .../webextensions/api/tabs/tab_id_none/index.md | 62 +++++ .../webextensions/api/tabs/tabstatus/index.html | 66 ----- .../webextensions/api/tabs/tabstatus/index.md | 66 +++++ .../api/tabs/togglereadermode/index.html | 79 ------ .../api/tabs/togglereadermode/index.md | 79 ++++++ .../webextensions/api/tabs/update/index.html | 162 ------------ .../add-ons/webextensions/api/tabs/update/index.md | 162 ++++++++++++ .../webextensions/api/tabs/windowtype/index.html | 73 ------ .../webextensions/api/tabs/windowtype/index.md | 73 ++++++ .../webextensions/api/tabs/zoomsettings/index.html | 75 ------ .../webextensions/api/tabs/zoomsettings/index.md | 75 ++++++ .../api/tabs/zoomsettingsmode/index.html | 75 ------ .../api/tabs/zoomsettingsmode/index.md | 75 ++++++ .../api/tabs/zoomsettingsscope/index.html | 73 ------ .../api/tabs/zoomsettingsscope/index.md | 73 ++++++ 118 files changed, 6470 insertions(+), 6470 deletions(-) delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md (limited to 'files/fr/mozilla/add-ons/webextensions/api/tabs') diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.html deleted file mode 100644 index 4813a4bfd8..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: tabs.captureTab() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/captureTab -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - captureTab - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureTab ---- -
{{AddonSidebar()}}
- -

Crée un URI de données codant une image de la zone visible de l'onglet donné. Vous devez avoir la permission <all_urls> pour utiliser cette méthode.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var capturing = browser.tabs.captureTab(
-  tabId,               // optional integer
-  options              // optional extensionTypes.ImageDetails
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. ID de l'onglet à capturer. Par défaut à l'onglet actif dans la fenêtre en cours.
-
options{{optional_inline}}
-
{{WebExtAPIRef('extensionTypes.ImageDetails')}}.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec une URL de données qui code une image de la zone visible de l'onglet capturé. Peut être affecté à la propriété 'src' d'un élément HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Capturez une image de l'onglet actif dans la fenêtre actuelle, avec les paramètres par défaut :

- -
function onCaptured(imageUri) {
-  console.log(imageUri);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var capturing = browser.tabs.captureTab();
-  capturing.then(onCaptured, onError);
-});
-
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md new file mode 100644 index 0000000000..4813a4bfd8 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturetab/index.md @@ -0,0 +1,100 @@ +--- +title: tabs.captureTab() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/captureTab +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - captureTab + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureTab +--- +
{{AddonSidebar()}}
+ +

Crée un URI de données codant une image de la zone visible de l'onglet donné. Vous devez avoir la permission <all_urls> pour utiliser cette méthode.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var capturing = browser.tabs.captureTab(
+  tabId,               // optional integer
+  options              // optional extensionTypes.ImageDetails
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. ID de l'onglet à capturer. Par défaut à l'onglet actif dans la fenêtre en cours.
+
options{{optional_inline}}
+
{{WebExtAPIRef('extensionTypes.ImageDetails')}}.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec une URL de données qui code une image de la zone visible de l'onglet capturé. Peut être affecté à la propriété 'src' d'un élément HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Capturez une image de l'onglet actif dans la fenêtre actuelle, avec les paramètres par défaut :

+ +
function onCaptured(imageUri) {
+  console.log(imageUri);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var capturing = browser.tabs.captureTab();
+  capturing.then(onCaptured, onError);
+});
+
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html deleted file mode 100644 index a606cd1e70..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: tabs.captureVisibleTab() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - captureVisibleTab - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab ---- -
{{AddonSidebar()}}
- -

Crée une URI de données codant une image de la zone visible de l'onglet actuellement actif dans la fenêtre spécifiée. Vous devez avoir la  permission <all_urls> pour utiliser cette méthode. (Alternativement, Chrome permet l'utilisation de cette méthode avec la permission activeTab et un geste utilisateur qualifiant).

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var capturing = browser.tabs.captureVisibleTab(
-  windowId,               // optional integer
-  options                 // optional extensionTypes.ImageDetails
-)
-
- -

Paramètres

- -
-
windowId{{optional_inline}}
-
integer. La fenêtre cible Par défaut à la fenêtre actuelle.
-
options{{optional_inline}}
-
{{WebExtAPIRef('extensionTypes.ImageDetails')}}.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec une URL de données qui code une image de la zone visible de l'onglet capturé. Peut être affecté à la propriété 'src' d'un élément HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Capturez une image de l'onglet actif dans la fenêtre actuelle, avec les paramètres par défaut :

- -
function onCaptured(imageUri) {
-  console.log(imageUri);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var capturing = browser.tabs.captureVisibleTab();
-  capturing.then(onCaptured, onError);
-});
-
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md new file mode 100644 index 0000000000..a606cd1e70 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/capturevisibletab/index.md @@ -0,0 +1,103 @@ +--- +title: tabs.captureVisibleTab() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - captureVisibleTab + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab +--- +
{{AddonSidebar()}}
+ +

Crée une URI de données codant une image de la zone visible de l'onglet actuellement actif dans la fenêtre spécifiée. Vous devez avoir la  permission <all_urls> pour utiliser cette méthode. (Alternativement, Chrome permet l'utilisation de cette méthode avec la permission activeTab et un geste utilisateur qualifiant).

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var capturing = browser.tabs.captureVisibleTab(
+  windowId,               // optional integer
+  options                 // optional extensionTypes.ImageDetails
+)
+
+ +

Paramètres

+ +
+
windowId{{optional_inline}}
+
integer. La fenêtre cible Par défaut à la fenêtre actuelle.
+
options{{optional_inline}}
+
{{WebExtAPIRef('extensionTypes.ImageDetails')}}.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec une URL de données qui code une image de la zone visible de l'onglet capturé. Peut être affecté à la propriété 'src' d'un élément HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Capturez une image de l'onglet actif dans la fenêtre actuelle, avec les paramètres par défaut :

+ +
function onCaptured(imageUri) {
+  console.log(imageUri);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var capturing = browser.tabs.captureVisibleTab();
+  capturing.then(onCaptured, onError);
+});
+
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.html deleted file mode 100644 index 146df70ced..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: tabs.connect() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/connect -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - connect - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/connect ---- -
{{AddonSidebar()}}
- -

Appelez cette fonction pour configurer une connexion entre les scripts d'arrière-plan de l'extension (ou d'autres scripts privilégiés, tels que les scripts d'arrière-plan de l'extrension (ou d'autres scripts privilégiés, tels que les scripts de pages d'options) et les scripts de contenu appartenant à cette extension et s'exécutant dans l'onglet spécifié. Cette fonction renvoie un objet {{WebExtAPIRef("runtime.Port")}}.

- -

Lorsque cela est appelée, l'événement {{WebExtAPIRef('runtime.onConnect')}} est déclenché dans tout script de contenu appartenant à cette extension qui s'exécute dans l'onglet spécifié. L'écouteur d'événement recevra un autre objet  {{WebExtAPIRef("runtime.Port")}}. Les deux parties peuvent ensuite utiliser les objets Port pour échanger des messages.

- -

Pour plus de détails, voir connection-based messaging.

- -

Syntax

- -
browser.tabs.connect(
-  tabId,      // integer
-  connectInfo // optional object
-)
-
- -

Parameters

- -
-
tabId
-
integer. ID of the tab whose content scripts we want to connect to.
-
connectInfo{{optional_inline}}
-

object.

-
-
name{{optional_inline}}
-
string. Will be passed into {{WebExtAPIRef("runtime.onConnect")}} event listeners in content scripts belonging to this extension and running in the specified tab.
-
frameId{{optional_inline}}
-
integer. Open a port to a specific frame identified by frameId instead of all frames in the tab.
-
-
-
- -

Return value

- -

{{WebExtAPIRef('runtime.Port')}}. A port that can be used to communicate with the content scripts running in the specified tab.

- -

Examples

- -

In this example a background script listens for a click on a browser action, then connects to the currently active tab, then sends a message using the Port that's returned from connect():

- -
function connectToTab(tabs) {
-  if (tabs.length > 0) {
-    var examplePort = browser.tabs.connect(
-      tabs[0].id,
-      {name: "tabs-connect-example"}
-    );
-    examplePort.postMessage({greeting: "Hi from background script"});
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var gettingActive = browser.tabs.query({
-    currentWindow: true, active: true
-  });
-  gettingActive.then(connectToTab, onError);
-});
-
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md new file mode 100644 index 0000000000..146df70ced --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/connect/index.md @@ -0,0 +1,120 @@ +--- +title: tabs.connect() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/connect +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - connect + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/connect +--- +
{{AddonSidebar()}}
+ +

Appelez cette fonction pour configurer une connexion entre les scripts d'arrière-plan de l'extension (ou d'autres scripts privilégiés, tels que les scripts d'arrière-plan de l'extrension (ou d'autres scripts privilégiés, tels que les scripts de pages d'options) et les scripts de contenu appartenant à cette extension et s'exécutant dans l'onglet spécifié. Cette fonction renvoie un objet {{WebExtAPIRef("runtime.Port")}}.

+ +

Lorsque cela est appelée, l'événement {{WebExtAPIRef('runtime.onConnect')}} est déclenché dans tout script de contenu appartenant à cette extension qui s'exécute dans l'onglet spécifié. L'écouteur d'événement recevra un autre objet  {{WebExtAPIRef("runtime.Port")}}. Les deux parties peuvent ensuite utiliser les objets Port pour échanger des messages.

+ +

Pour plus de détails, voir connection-based messaging.

+ +

Syntax

+ +
browser.tabs.connect(
+  tabId,      // integer
+  connectInfo // optional object
+)
+
+ +

Parameters

+ +
+
tabId
+
integer. ID of the tab whose content scripts we want to connect to.
+
connectInfo{{optional_inline}}
+

object.

+
+
name{{optional_inline}}
+
string. Will be passed into {{WebExtAPIRef("runtime.onConnect")}} event listeners in content scripts belonging to this extension and running in the specified tab.
+
frameId{{optional_inline}}
+
integer. Open a port to a specific frame identified by frameId instead of all frames in the tab.
+
+
+
+ +

Return value

+ +

{{WebExtAPIRef('runtime.Port')}}. A port that can be used to communicate with the content scripts running in the specified tab.

+ +

Examples

+ +

In this example a background script listens for a click on a browser action, then connects to the currently active tab, then sends a message using the Port that's returned from connect():

+ +
function connectToTab(tabs) {
+  if (tabs.length > 0) {
+    var examplePort = browser.tabs.connect(
+      tabs[0].id,
+      {name: "tabs-connect-example"}
+    );
+    examplePort.postMessage({greeting: "Hi from background script"});
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var gettingActive = browser.tabs.query({
+    currentWindow: true, active: true
+  });
+  gettingActive.then(connectToTab, onError);
+});
+
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.html deleted file mode 100644 index 95244d6e3e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.html +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: tabs.create() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/create -tags: - - API - - Add-ons - - Create - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/create ---- -
{{AddonSidebar()}}
- -

Crée un nouvel onglet

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var creating = browser.tabs.create(
-  createProperties   // object
-)
-
- -

Paramètres

- -
-
createProperties
-

object.Propriétés pour donner le nouvel onglet. Pour en savoir plus sur ces propriétés, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.

-
-
active{{optional_inline}}
-
boolean. Si l'onglet doit devenir l'onglet actif dans la fenêtre. Si elle est false, elle n'a aucun effet. N'affecte pas si la fenêtre est mise au point (voir {{WebExtAPIRef('windows.update')}}). Par défaut à  true.
-
cookieStoreId {{optional_inline}}
-
string. Utilisez-le pour créer un onglet dont l'ID de cookie estCette option n'est disponible que si l'extension a  la  permission "cookies".
-
index{{optional_inline}}
-
integer. La position que l'onglet devrait prendre dans la fenêtre. La valeur fournie sera comprise entre zéro et le nombre d'onglets dans la fenêtre.
-
openerTabId{{optional_inline}}
-
integer. L'ID de l'onglet qui a ouvert cet onglet. Si spécifié, l'onglet d'ouverture doit être dans la même fenêtre que l'onglet nouvellement créé.
-
openInReaderMode{{optional_inline}}
-
boolean. si true, ouvrez cet onglet en mode lecture. Par défaut à  false.
-
pinned{{optional_inline}}
-
boolean. Si l'onglet doit être épinglé. Par défaut à false.
-
selected{{optional_inline}}
-

boolean. Si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. Par défaut à true.

-

Attention : Cette propriété est obsolète et n'est pas prise en charge dans Firefox. Utilisez  actif à la place.

-
-
url{{optional_inline}}
-

string. 'URL permettant de naviguer dans l'onglet initialement. Par défaut à la page Nouvel onglet.

-

Les URL complètes doivent inclure un schéma (i.e. 'http://www.google.com', par 'www.google.com').

-

Pour des raisons de sécurité, dans Firefox, il se peut que ce ne soit pas une URL privilégiée. Le passage de l'une des URL suivantes échouera :

-
    -
  • chrome: URLs
    • -
  • javascript: URLs
    • -
  • data: URLs
    • -
  • file: URLs (c'est-à-dire, fichiers sur le système de fichiers, cependant, pour utiliser un fichier empaqueté à l'intérieur de l'extension, voir ci-dessous)
    • -
  • privileged about: URLs (par exemple, about:config, about:addons, about:debugging). Les URL non privilégiées (e.g., about:blank) sont autorisés.
    • -
  • La page Nouvel onglet (about:newtab) peut être ouverte si aucune valeur n'est fournie pour l'URL.
    • -
- -

Pour charger une page fournie avec votre extension, spécifiez une URL absolue à partir du fichier manifest.json de l'extension. Par exemple :  '/path/to/my-page.html'. Si vous omettez le premier caractère '/', l'URL est traitée comme une URL relative et différents navigateurs peuvent construire différentes URL absolues.

-
-
windowId{{optional_inline}}
-
integer. La fenêtre pour créer le nouvel onglet. Par défaut à la fenêtre actuelle.
-
-
-
- -

Valeur retournée

- -

A Promise that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing details about the created tab. If the tab could not be created (for example, because url used a privileged scheme) the promise will be rejected with an error message.

- -

Exemples

- -

Ouvre "https://example.org" dans un nouvel onglet :

- -
function onCreated(tab) {
-  console.log(`Created new tab: ${tab.id}`)
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var creating = browser.tabs.create({
-    url:"https://example.org"
-  });
-  creating.then(onCreated, onError);
-});
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.create", 10)}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md new file mode 100644 index 0000000000..95244d6e3e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/create/index.md @@ -0,0 +1,137 @@ +--- +title: tabs.create() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/create +tags: + - API + - Add-ons + - Create + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/create +--- +
{{AddonSidebar()}}
+ +

Crée un nouvel onglet

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var creating = browser.tabs.create(
+  createProperties   // object
+)
+
+ +

Paramètres

+ +
+
createProperties
+

object.Propriétés pour donner le nouvel onglet. Pour en savoir plus sur ces propriétés, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.

+
+
active{{optional_inline}}
+
boolean. Si l'onglet doit devenir l'onglet actif dans la fenêtre. Si elle est false, elle n'a aucun effet. N'affecte pas si la fenêtre est mise au point (voir {{WebExtAPIRef('windows.update')}}). Par défaut à  true.
+
cookieStoreId {{optional_inline}}
+
string. Utilisez-le pour créer un onglet dont l'ID de cookie estCette option n'est disponible que si l'extension a  la  permission "cookies".
+
index{{optional_inline}}
+
integer. La position que l'onglet devrait prendre dans la fenêtre. La valeur fournie sera comprise entre zéro et le nombre d'onglets dans la fenêtre.
+
openerTabId{{optional_inline}}
+
integer. L'ID de l'onglet qui a ouvert cet onglet. Si spécifié, l'onglet d'ouverture doit être dans la même fenêtre que l'onglet nouvellement créé.
+
openInReaderMode{{optional_inline}}
+
boolean. si true, ouvrez cet onglet en mode lecture. Par défaut à  false.
+
pinned{{optional_inline}}
+
boolean. Si l'onglet doit être épinglé. Par défaut à false.
+
selected{{optional_inline}}
+

boolean. Si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. Par défaut à true.

+

Attention : Cette propriété est obsolète et n'est pas prise en charge dans Firefox. Utilisez  actif à la place.

+
+
url{{optional_inline}}
+

string. 'URL permettant de naviguer dans l'onglet initialement. Par défaut à la page Nouvel onglet.

+

Les URL complètes doivent inclure un schéma (i.e. 'http://www.google.com', par 'www.google.com').

+

Pour des raisons de sécurité, dans Firefox, il se peut que ce ne soit pas une URL privilégiée. Le passage de l'une des URL suivantes échouera :

+
    +
  • chrome: URLs
    • +
  • javascript: URLs
    • +
  • data: URLs
    • +
  • file: URLs (c'est-à-dire, fichiers sur le système de fichiers, cependant, pour utiliser un fichier empaqueté à l'intérieur de l'extension, voir ci-dessous)
    • +
  • privileged about: URLs (par exemple, about:config, about:addons, about:debugging). Les URL non privilégiées (e.g., about:blank) sont autorisés.
    • +
  • La page Nouvel onglet (about:newtab) peut être ouverte si aucune valeur n'est fournie pour l'URL.
    • +
+ +

Pour charger une page fournie avec votre extension, spécifiez une URL absolue à partir du fichier manifest.json de l'extension. Par exemple :  '/path/to/my-page.html'. Si vous omettez le premier caractère '/', l'URL est traitée comme une URL relative et différents navigateurs peuvent construire différentes URL absolues.

+
+
windowId{{optional_inline}}
+
integer. La fenêtre pour créer le nouvel onglet. Par défaut à la fenêtre actuelle.
+
+
+
+ +

Valeur retournée

+ +

A Promise that will be fulfilled with a {{WebExtAPIRef('tabs.Tab')}} object containing details about the created tab. If the tab could not be created (for example, because url used a privileged scheme) the promise will be rejected with an error message.

+ +

Exemples

+ +

Ouvre "https://example.org" dans un nouvel onglet :

+ +
function onCreated(tab) {
+  console.log(`Created new tab: ${tab.id}`)
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var creating = browser.tabs.create({
+    url:"https://example.org"
+  });
+  creating.then(onCreated, onError);
+});
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.create", 10)}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.html deleted file mode 100644 index 8a9a96a508..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: tabs.detectLanguage() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/detectLanguage -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - detectLanguage - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/detectLanguage ---- -
{{AddonSidebar()}}
- -

Détecte la langue principale du contenu dans un onglet, en utilisant le détecteur de langue compact (CLD).

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var detecting = browser.tabs.detectLanguage(
-  tabId,                  // optional integer
-  callback                // optional function
-)
-
- -

Paramètres

- -
-
tabId {{optional_inline}}
-
integer. Par défaut à l'onglet actif de la fenêtre en cours.
-
callback {{optional_inline}}
-
function. Actuellement, si un tabId est spécifié, cette méthode utilise ce rappel pour renvoyer les résultats au lieu de renvoyer une promesse. Le rappel reçoit comme seul paramètre d'entrée une chaîne de caractères contenant le code de langue détecté en ou fr.
-
- -

Valeur retournée

- -

Une Promisequi sera remplie avec une chaîne représentant un code de langue ISO tel que en ou fr. Pour une liste complète des langues prises en charge par cette méthode, see kLanguageInfoTable. Pour une langue inconnue, "und" sera retourné (mais voir bug 1288263). Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Détecter et enregistrer la langue de l'onglet actif lorsque l'utilisateur clique sur une action du navigateur :

- -
function onLanguageDetected(lang) {
-  console.log(`Language is: ${lang}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var detecting = browser.tabs.detectLanguage();
-  detecting.then(onLanguageDetected, onError);
-});
- -

Détecter et enregistrer la langue de chaque onglet ouvert lorsque l'utilisateur clique sur une action du navigateur (notez que cet exemple nécessite  la permission "tabs") :

- -
function onLanguageDetected(url, lang) {
-  console.log(`Language in ${url} is: ${lang}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function detectLanguages(tabs) {
-  for (tab of tabs) {
-    var onFulfilled = onLanguageDetected.bind(null, tab.url);
-    var detecting = browser.tabs.detectLanguage(tab.id);
-    detecting.then(onFulfilled, onError);
-  }
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var querying = browser.tabs.query({});
-  querying.then(detectLanguages, onError);
-});
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- - - -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md new file mode 100644 index 0000000000..8a9a96a508 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/detectlanguage/index.md @@ -0,0 +1,127 @@ +--- +title: tabs.detectLanguage() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/detectLanguage +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - detectLanguage + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/detectLanguage +--- +
{{AddonSidebar()}}
+ +

Détecte la langue principale du contenu dans un onglet, en utilisant le détecteur de langue compact (CLD).

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var detecting = browser.tabs.detectLanguage(
+  tabId,                  // optional integer
+  callback                // optional function
+)
+
+ +

Paramètres

+ +
+
tabId {{optional_inline}}
+
integer. Par défaut à l'onglet actif de la fenêtre en cours.
+
callback {{optional_inline}}
+
function. Actuellement, si un tabId est spécifié, cette méthode utilise ce rappel pour renvoyer les résultats au lieu de renvoyer une promesse. Le rappel reçoit comme seul paramètre d'entrée une chaîne de caractères contenant le code de langue détecté en ou fr.
+
+ +

Valeur retournée

+ +

Une Promisequi sera remplie avec une chaîne représentant un code de langue ISO tel que en ou fr. Pour une liste complète des langues prises en charge par cette méthode, see kLanguageInfoTable. Pour une langue inconnue, "und" sera retourné (mais voir bug 1288263). Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Détecter et enregistrer la langue de l'onglet actif lorsque l'utilisateur clique sur une action du navigateur :

+ +
function onLanguageDetected(lang) {
+  console.log(`Language is: ${lang}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var detecting = browser.tabs.detectLanguage();
+  detecting.then(onLanguageDetected, onError);
+});
+ +

Détecter et enregistrer la langue de chaque onglet ouvert lorsque l'utilisateur clique sur une action du navigateur (notez que cet exemple nécessite  la permission "tabs") :

+ +
function onLanguageDetected(url, lang) {
+  console.log(`Language in ${url} is: ${lang}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function detectLanguages(tabs) {
+  for (tab of tabs) {
+    var onFulfilled = onLanguageDetected.bind(null, tab.url);
+    var detecting = browser.tabs.detectLanguage(tab.id);
+    detecting.then(onFulfilled, onError);
+  }
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var querying = browser.tabs.query({});
+  querying.then(detectLanguages, onError);
+});
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ + + +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.html deleted file mode 100644 index c1dd5c9470..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.html +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: tabs.discard() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/discard -tags: - - API - - Add-ons - - Extensions - - Méthode - - WebExtensions - - discard - - onglets - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/discard ---- -
{{AddonSidebar()}}
- -

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 {{WebExtAPIRef("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.

- -

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);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.discard", 10)}}

- -

Note :

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md new file mode 100644 index 0000000000..c1dd5c9470 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/discard/index.md @@ -0,0 +1,113 @@ +--- +title: tabs.discard() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/discard +tags: + - API + - Add-ons + - Extensions + - Méthode + - WebExtensions + - discard + - onglets + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/discard +--- +
{{AddonSidebar()}}
+ +

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 {{WebExtAPIRef("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.

+ +

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);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.discard", 10)}}

+ +

Note :

+ +

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

+
+ + 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 deleted file mode 100644 index 177cec75a3..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: tabs.duplicate() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate -browser-compat: webextensions.api.tabs.duplicate ---- -
{{AddonSidebar()}}
- -

Duplique un onglet dont l'identifiant est donné.

- -

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

- -

Syntaxe

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

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 de retour

- -

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 : À 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'identifiant de l'onglet nouvellement créé :

- -
-function onDuplicated(tabInfo) {
-  console.log(tabInfo.id);
-}
-
-function onError(error) {
-  console.error(error);
-}
-
-// Duplique le premier onglet du tableau
-function duplicateFirstTab(tabs) {
-  console.log(tabs);
-  if (tabs.length > 0) {
-    let duplicating = browser.tabs.duplicate(tabs[0].id);
-    duplicating.then(onDuplicated, onError);
-  }
-}
-
-// On récupère tous les onglets ouverts
-let querying = browser.tabs.query({});
-querying.then(duplicateFirstTab, onError);
- -

Exemple d'extensions

- - - -

Compatibilité des navigateurs

- -

{{Compat}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md new file mode 100644 index 0000000000..177cec75a3 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/duplicate/index.md @@ -0,0 +1,120 @@ +--- +title: tabs.duplicate() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/duplicate +browser-compat: webextensions.api.tabs.duplicate +--- +
{{AddonSidebar()}}
+ +

Duplique un onglet dont l'identifiant est donné.

+ +

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

+ +

Syntaxe

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

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 de retour

+ +

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 : À 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'identifiant de l'onglet nouvellement créé :

+ +
+function onDuplicated(tabInfo) {
+  console.log(tabInfo.id);
+}
+
+function onError(error) {
+  console.error(error);
+}
+
+// Duplique le premier onglet du tableau
+function duplicateFirstTab(tabs) {
+  console.log(tabs);
+  if (tabs.length > 0) {
+    let duplicating = browser.tabs.duplicate(tabs[0].id);
+    duplicating.then(onDuplicated, onError);
+  }
+}
+
+// On récupère tous les onglets ouverts
+let querying = browser.tabs.query({});
+querying.then(duplicateFirstTab, onError);
+ +

Exemple d'extensions

+ + + +

Compatibilité des navigateurs

+ +

{{Compat}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.html deleted file mode 100644 index 0b790a369a..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.html +++ /dev/null @@ -1,173 +0,0 @@ ---- -title: tabs.executeScript() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - executeScript - - onglets - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript ---- -
{{AddonSidebar()}}
- -

Injecte du code JavaScript dans une page.

- -

Vous pouvez injecter du code dans des pages dont l'URL peut être exprimée à l'aide d'un modèle de correspondance : son schéma doit être "http", "https", "file", "ftp". Pour ce faire, vous devez disposer de la permission pour l'URL de la page, soit explicitement en tant que permission d'hôte, ou via la permission activeTab.

- -

Vous pouvez également injecter du code dans des pages empaquetées avec votre propre extension :

- -
browser.tabs.create({url: "/my-page.html"}).then(() => {
-  browser.tabs.executeScript({
-    code: `console.log('location:', window.location.href);`
-  });
-});
- -

Vous n'avez pas besoin de permissions spéciales pour le faire.

- -

Vous ne pouvez pas injecter de code dans les pages intégrées du navigateur, par exemple : about:debugging, about:addons, ou sur la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide.

- -

Les scripts que vous injectez s’appellent des scripts de contenu. En savoir plus sur les scripts de contenu.

- -

Il s’agit d’une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var executing = browser.tabs.executeScript(
-  tabId,                 // optional integer
-  details                // object
-)
-
- -

Paramètres

- -
-
tabId {{optional_inline}}
-
integer. L’ID de l’onglet dans lequel exécuter le script. Par défaut, l’onglet actif de la fenêtre en cours.
-
details
-

Un objet décrivant le script à exécuter. Il contient les propriétés suivantes :

-
-
allFrames {{optional_inline}}
-
boolean. Si true, le code sera injecté dans toutes les cadres de la page courante. Si true et frameId est défini, alors il y aura une erreur, frameId et allFrames sont mutuellement exclusifs. Si c'est false, le code n'est injecté que dans le cadre supérieur. La valeur par défaut est false.
-
code {{optional_inline}}
-
string. Code à injecter, sous la forme d’une chaine de texte. Attention : n’utilisez pas cette propriété pour interpoler des données non sûres dans JavaScript, car cela pourrait introduire une faille de sécurité.
-
file {{optional_inline}}
-
string. Chemin d’accès à un fichier contenant le code à injecter. Dans Firefox, les URL relatives ne commençant pas à la racine de l'extension sont résolues par rapport à l'URL de la page en cours. Dans Chrome, ces URL sont résolues par rapport à l’URL de base de l’extension. Pour travailler avec plusieurs navigateurs, vous pouvez spécifier le chemin comme une URL relative, en commençant à la racine de l’extension, comme ceci : "/path/to/script.js".
-
frameId {{optional_inline}}
-
integer. Le cadre où le code doit être injecté. La valeur par défaut est 0 (le cadre de niveau supérieur).
-
matchAboutBlank {{optional_inline}}
-
boolean. Si true, le code sera injecté dans des cadres about:blank et about:srcdoc inclus depuis une page si votre extension a accès à leur document parent. Le code ne peut pas être inséré dans les cadres about: de niveau supérieur. Par défaut, false.
-
runAt {{optional_inline}}
-
{{WebExtAPIRef('extensionTypes.RunAt')}}. Le moment le plus tôt auquel le code sera injecté dans l’onglet. Par défaut, document_idle.
-
-
-
- -

Valeur de retour

- -

Une Promise résolue avec un tableau d’objets représentant le résultat du script dans chaque cadre où le script a été injecté.

- -

Le résultat du script est la dernière instruction évaluée, ce qui est similaire à ce qui serait produit (les résultats, pas les affichages de console.log()) si vous exécutiez le script dans la Console Web. Par exemple, considérez un script comme celui-ci :

- -
var foo='my result';foo;
- -

Ici, le tableau des résultats contiendra la chaîne "my result" en tant qu’élément. Les valeurs de résultat doivent être clonables tructurées. La dernière déclaration peut également être une Promise, mais cette fonctionnalité n'est pas supportée par la bibliothèque webextension-polyfill.
- Si une erreur se produit, la promesse sera rejetée avec un message d’erreur.

- -

Exemples

- -

Cet exemple exécute un extrait de code d’une ligne dans l’onglet actuellement actif :

- -
function onExecuted(result) {
-  console.log(`We made it green`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var makeItGreen = 'document.body.style.border = "5px solid green"';
-
-var executing = browser.tabs.executeScript({
-  code: makeItGreen
-});
-executing.then(onExecuted, onError);
- -

L’exemple suivant exécute un script à partir d’un fichier empaqueté avec l’extension appelé content-script.js. Le script est exécuté dans l’onglet actuellement actif. Le script est exécuté dans les sous-cadres ainsi que dans le document principal :

- -
function onExecuted(result) {
-  console.log(`We executed in all subframes`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var executing = browser.tabs.executeScript({
-  file: "/content-script.js",
-  allFrames: true
-});
-executing.then(onExecuted, onError);
- -

L’exemple suivant exécute un script à partir d’un fichier empaqueté avec l’extension appelé content-script.js. Le script est exécuté dans l’onglet ayant l’ID 2 :

- -
function onExecuted(result) {
-  console.log(`We executed in tab 2`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var executing = browser.tabs.executeScript(
-  2, {
-    file: "/content-script.js"
-});
-executing.then(onExecuted, onError);
- -

{{WebExtExamples}}

- -

Compatibilité des navigateurs

- -

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

- -

Note :

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md new file mode 100644 index 0000000000..0b790a369a --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/executescript/index.md @@ -0,0 +1,173 @@ +--- +title: tabs.executeScript() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - executeScript + - onglets + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/executeScript +--- +
{{AddonSidebar()}}
+ +

Injecte du code JavaScript dans une page.

+ +

Vous pouvez injecter du code dans des pages dont l'URL peut être exprimée à l'aide d'un modèle de correspondance : son schéma doit être "http", "https", "file", "ftp". Pour ce faire, vous devez disposer de la permission pour l'URL de la page, soit explicitement en tant que permission d'hôte, ou via la permission activeTab.

+ +

Vous pouvez également injecter du code dans des pages empaquetées avec votre propre extension :

+ +
browser.tabs.create({url: "/my-page.html"}).then(() => {
+  browser.tabs.executeScript({
+    code: `console.log('location:', window.location.href);`
+  });
+});
+ +

Vous n'avez pas besoin de permissions spéciales pour le faire.

+ +

Vous ne pouvez pas injecter de code dans les pages intégrées du navigateur, par exemple : about:debugging, about:addons, ou sur la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide.

+ +

Les scripts que vous injectez s’appellent des scripts de contenu. En savoir plus sur les scripts de contenu.

+ +

Il s’agit d’une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var executing = browser.tabs.executeScript(
+  tabId,                 // optional integer
+  details                // object
+)
+
+ +

Paramètres

+ +
+
tabId {{optional_inline}}
+
integer. L’ID de l’onglet dans lequel exécuter le script. Par défaut, l’onglet actif de la fenêtre en cours.
+
details
+

Un objet décrivant le script à exécuter. Il contient les propriétés suivantes :

+
+
allFrames {{optional_inline}}
+
boolean. Si true, le code sera injecté dans toutes les cadres de la page courante. Si true et frameId est défini, alors il y aura une erreur, frameId et allFrames sont mutuellement exclusifs. Si c'est false, le code n'est injecté que dans le cadre supérieur. La valeur par défaut est false.
+
code {{optional_inline}}
+
string. Code à injecter, sous la forme d’une chaine de texte. Attention : n’utilisez pas cette propriété pour interpoler des données non sûres dans JavaScript, car cela pourrait introduire une faille de sécurité.
+
file {{optional_inline}}
+
string. Chemin d’accès à un fichier contenant le code à injecter. Dans Firefox, les URL relatives ne commençant pas à la racine de l'extension sont résolues par rapport à l'URL de la page en cours. Dans Chrome, ces URL sont résolues par rapport à l’URL de base de l’extension. Pour travailler avec plusieurs navigateurs, vous pouvez spécifier le chemin comme une URL relative, en commençant à la racine de l’extension, comme ceci : "/path/to/script.js".
+
frameId {{optional_inline}}
+
integer. Le cadre où le code doit être injecté. La valeur par défaut est 0 (le cadre de niveau supérieur).
+
matchAboutBlank {{optional_inline}}
+
boolean. Si true, le code sera injecté dans des cadres about:blank et about:srcdoc inclus depuis une page si votre extension a accès à leur document parent. Le code ne peut pas être inséré dans les cadres about: de niveau supérieur. Par défaut, false.
+
runAt {{optional_inline}}
+
{{WebExtAPIRef('extensionTypes.RunAt')}}. Le moment le plus tôt auquel le code sera injecté dans l’onglet. Par défaut, document_idle.
+
+
+
+ +

Valeur de retour

+ +

Une Promise résolue avec un tableau d’objets représentant le résultat du script dans chaque cadre où le script a été injecté.

+ +

Le résultat du script est la dernière instruction évaluée, ce qui est similaire à ce qui serait produit (les résultats, pas les affichages de console.log()) si vous exécutiez le script dans la Console Web. Par exemple, considérez un script comme celui-ci :

+ +
var foo='my result';foo;
+ +

Ici, le tableau des résultats contiendra la chaîne "my result" en tant qu’élément. Les valeurs de résultat doivent être clonables tructurées. La dernière déclaration peut également être une Promise, mais cette fonctionnalité n'est pas supportée par la bibliothèque webextension-polyfill.
+ Si une erreur se produit, la promesse sera rejetée avec un message d’erreur.

+ +

Exemples

+ +

Cet exemple exécute un extrait de code d’une ligne dans l’onglet actuellement actif :

+ +
function onExecuted(result) {
+  console.log(`We made it green`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var makeItGreen = 'document.body.style.border = "5px solid green"';
+
+var executing = browser.tabs.executeScript({
+  code: makeItGreen
+});
+executing.then(onExecuted, onError);
+ +

L’exemple suivant exécute un script à partir d’un fichier empaqueté avec l’extension appelé content-script.js. Le script est exécuté dans l’onglet actuellement actif. Le script est exécuté dans les sous-cadres ainsi que dans le document principal :

+ +
function onExecuted(result) {
+  console.log(`We executed in all subframes`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var executing = browser.tabs.executeScript({
+  file: "/content-script.js",
+  allFrames: true
+});
+executing.then(onExecuted, onError);
+ +

L’exemple suivant exécute un script à partir d’un fichier empaqueté avec l’extension appelé content-script.js. Le script est exécuté dans l’onglet ayant l’ID 2 :

+ +
function onExecuted(result) {
+  console.log(`We executed in tab 2`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var executing = browser.tabs.executeScript(
+  2, {
+    file: "/content-script.js"
+});
+executing.then(onExecuted, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité des navigateurs

+ +

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

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.html deleted file mode 100644 index c889a95e70..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: tabs.get() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/get -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - get - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/get ---- -
{{AddonSidebar()}}
- -

Étant donné un ID d'onglet, obtenez les détails de l'onglet en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var getting = browser.tabs.get(
-  tabId              // integer
-)
-
- -

Paramètres

- -
-
tabId
-
integer. ID de l'onglet à obtenir.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Obtenir des informations sur un onglet lorsqu'il est activé :

- -
async function logListener(info) {
-  try {
-    let tabInfo = await browser.tabs.get(info.tabId);
-    console.log(tabInfo);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-browser.tabs.onActivated.addListener(logListener);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md new file mode 100644 index 0000000000..c889a95e70 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/get/index.md @@ -0,0 +1,95 @@ +--- +title: tabs.get() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/get +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - get + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/get +--- +
{{AddonSidebar()}}
+ +

Étant donné un ID d'onglet, obtenez les détails de l'onglet en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var getting = browser.tabs.get(
+  tabId              // integer
+)
+
+ +

Paramètres

+ +
+
tabId
+
integer. ID de l'onglet à obtenir.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Obtenir des informations sur un onglet lorsqu'il est activé :

+ +
async function logListener(info) {
+  try {
+    let tabInfo = await browser.tabs.get(info.tabId);
+    console.log(tabInfo);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+browser.tabs.onActivated.addListener(logListener);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.html deleted file mode 100644 index da8b786701..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: tabs.getAllInWindow() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/getAllInWindow -tags: - - API - - Add-ons - - Deprecated - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getAllInWindow - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getAllInWindow ---- -
{{AddonSidebar}} -
-

Deprecated
- Cette méthode est dépréciée. Utilisez {{WebExtAPIRef("tabs.query", "tabs.query({currentWindow: true})")}} à la place.

-
-
- -

Obtient des détails sur tous les onglets de la fenêtre spécifiée.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var getting = browser.tabs.getAllInWindow(
-  windowId            // optional integer
-)
-
- -

Paramètres

- -
-
windowId{{Optional_Inline}}
-
integer. Par défaut à la fenêtre actuelle.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec un tableau d'ojets {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur tous les onglets de la fenêtre. Si la fenêtre n'a pas pu être trouvée ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md new file mode 100644 index 0000000000..da8b786701 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getallinwindow/index.md @@ -0,0 +1,88 @@ +--- +title: tabs.getAllInWindow() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/getAllInWindow +tags: + - API + - Add-ons + - Deprecated + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getAllInWindow + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getAllInWindow +--- +
{{AddonSidebar}} +
+

Deprecated
+ Cette méthode est dépréciée. Utilisez {{WebExtAPIRef("tabs.query", "tabs.query({currentWindow: true})")}} à la place.

+
+
+ +

Obtient des détails sur tous les onglets de la fenêtre spécifiée.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var getting = browser.tabs.getAllInWindow(
+  windowId            // optional integer
+)
+
+ +

Paramètres

+ +
+
windowId{{Optional_Inline}}
+
integer. Par défaut à la fenêtre actuelle.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un tableau d'ojets {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur tous les onglets de la fenêtre. Si la fenêtre n'a pas pu être trouvée ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.html deleted file mode 100644 index ee26a84063..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.html +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: tabs.getCurrent() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/getCurrent -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getCurrent - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getCurrent ---- -
{{AddonSidebar()}}
- -

Obtenez un {{WebExtAPIRef("tabs.Tab")}} contenant des informations sur l'onglet dans lequel ce script s'exécute.

- -

Vous pouvez appeler cette fonction dans des contextes comportant un onglet de navigateur, par exemple une pages d'options. Si vous l'appelez à partir d'un script d'arrière-plan ou d'une fenêtre contextuelle, elle renverra undefined.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingCurrent = browser.tabs.getCurrent()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet en cours. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Obtenir les informations sur l'onglet en cours :

- -
function onGot(tabInfo) {
-  console.log(tabInfo);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var gettingCurrent = browser.tabs.getCurrent();
-gettingCurrent.then(onGot, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md new file mode 100644 index 0000000000..ee26a84063 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getcurrent/index.md @@ -0,0 +1,94 @@ +--- +title: tabs.getCurrent() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/getCurrent +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getCurrent + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getCurrent +--- +
{{AddonSidebar()}}
+ +

Obtenez un {{WebExtAPIRef("tabs.Tab")}} contenant des informations sur l'onglet dans lequel ce script s'exécute.

+ +

Vous pouvez appeler cette fonction dans des contextes comportant un onglet de navigateur, par exemple une pages d'options. Si vous l'appelez à partir d'un script d'arrière-plan ou d'une fenêtre contextuelle, elle renverra undefined.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingCurrent = browser.tabs.getCurrent()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des informations sur l'onglet en cours. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Obtenir les informations sur l'onglet en cours :

+ +
function onGot(tabInfo) {
+  console.log(tabInfo);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var gettingCurrent = browser.tabs.getCurrent();
+gettingCurrent.then(onGot, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.html deleted file mode 100644 index 20fe260b83..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: tabs.getSelected() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/getSelected -tags: - - API - - Add-ons - - Deprecated - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getSelected - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getSelected ---- -
{{AddonSidebar()}}
- -
-

Attention : Cette méthode est dépréciée. utilisez {{WebExtAPIRef("tabs.query", "tabs.query({active: true})")}} à la place.

-
- -

Obtient l'onglet sélectionné dans la fenêtre spécifiée

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingSelected = browser.tabs.getSelected(
-  windowId           // optional integer
-)
-
- -

Paramètres

- -
-
windowId{{optional_inline}}
-
integer. Par défaut à la fenêtre actuelle.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec un objet tabs.Tab contenant des informations sur l'onglet sélectionné. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md new file mode 100644 index 0000000000..20fe260b83 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getselected/index.md @@ -0,0 +1,87 @@ +--- +title: tabs.getSelected() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/getSelected +tags: + - API + - Add-ons + - Deprecated + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getSelected + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getSelected +--- +
{{AddonSidebar()}}
+ +
+

Attention : Cette méthode est dépréciée. utilisez {{WebExtAPIRef("tabs.query", "tabs.query({active: true})")}} à la place.

+
+ +

Obtient l'onglet sélectionné dans la fenêtre spécifiée

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingSelected = browser.tabs.getSelected(
+  windowId           // optional integer
+)
+
+ +

Paramètres

+ +
+
windowId{{optional_inline}}
+
integer. Par défaut à la fenêtre actuelle.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet tabs.Tab contenant des informations sur l'onglet sélectionné. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.html deleted file mode 100644 index 7b97eca351..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: tabs.getZoom() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/getZoom -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - getZoom - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getZoom ---- -
{{AddonSidebar()}}
- -

Obtient le facteur de zoom actuel pour l'onglet spécifié.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingZoom = browser.tabs.getZoom(
-  tabId                     // optional integer
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet pour obtenir le facteur de zoom actuel. Par défaut à l'onglet actif de la fenêtre en cours.
-
- -

Valeur retournée

- -

Une Promise qui sera satisfaite avec le facteur de zoom actuel de l'onglet, sous la forme d'un nombre compris entre 0,3 et 3. Si l'onglet n'a pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Obtenez le facteur de zoom  pour l'onglet actuel :

- -
function onGot(zoom) {
-  console.log(zoom);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var gettingZoom = browser.tabs.getZoom();
-gettingZoom.then(onGot, onError);
- -

Obtenez le facteur zoom pour l'onglet dont l'ID est 2:

- -
function onGot(zoom) {
-  console.log(zoom);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var gettingZoom = browser.tabs.getZoom(2);
-gettingZoom.then(onGot, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md new file mode 100644 index 0000000000..7b97eca351 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoom/index.md @@ -0,0 +1,110 @@ +--- +title: tabs.getZoom() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/getZoom +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - getZoom + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getZoom +--- +
{{AddonSidebar()}}
+ +

Obtient le facteur de zoom actuel pour l'onglet spécifié.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingZoom = browser.tabs.getZoom(
+  tabId                     // optional integer
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet pour obtenir le facteur de zoom actuel. Par défaut à l'onglet actif de la fenêtre en cours.
+
+ +

Valeur retournée

+ +

Une Promise qui sera satisfaite avec le facteur de zoom actuel de l'onglet, sous la forme d'un nombre compris entre 0,3 et 3. Si l'onglet n'a pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Obtenez le facteur de zoom  pour l'onglet actuel :

+ +
function onGot(zoom) {
+  console.log(zoom);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var gettingZoom = browser.tabs.getZoom();
+gettingZoom.then(onGot, onError);
+ +

Obtenez le facteur zoom pour l'onglet dont l'ID est 2:

+ +
function onGot(zoom) {
+  console.log(zoom);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var gettingZoom = browser.tabs.getZoom(2);
+gettingZoom.then(onGot, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.html deleted file mode 100644 index 89934d27f2..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: tabs.getZoomSettings() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/getZoomSettings -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - getZoomSettings - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getZoomSettings ---- -
{{AddonSidebar()}}
- -

Obtient les paramètres de zoom actuels pour un onglet spécifié.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingZoomSettings = browser.tabs.getZoomSettings(
-  tabId                       // optional integer
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet pour obtenir les paramètres de zoom actuels. Par défaut à l'onglet actif de la fenêtre en cours.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.ZoomSettings')}} représentant les paramètres de zoom actuels de l'onglet. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Obtenez les paramètres de zoom pour l'onglet en cours :

- -
function onGot(settings) {
-  console.log(settings);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var gettingZoomSettings = browser.tabs.getZoomSettings();
-gettingZoomSettings.then(onGot, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md new file mode 100644 index 0000000000..89934d27f2 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/getzoomsettings/index.md @@ -0,0 +1,97 @@ +--- +title: tabs.getZoomSettings() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/getZoomSettings +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - getZoomSettings + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/getZoomSettings +--- +
{{AddonSidebar()}}
+ +

Obtient les paramètres de zoom actuels pour un onglet spécifié.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingZoomSettings = browser.tabs.getZoomSettings(
+  tabId                       // optional integer
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet pour obtenir les paramètres de zoom actuels. Par défaut à l'onglet actif de la fenêtre en cours.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.ZoomSettings')}} représentant les paramètres de zoom actuels de l'onglet. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Obtenez les paramètres de zoom pour l'onglet en cours :

+ +
function onGot(settings) {
+  console.log(settings);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var gettingZoomSettings = browser.tabs.getZoomSettings();
+gettingZoomSettings.then(onGot, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.html deleted file mode 100644 index f0c2dc8c64..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: tabs.goBack() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/goBack -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - hoBack -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/goBack ---- -
{{AddonSidebar()}}
- -

Naviguer à la page précédente dans l'historique de l'onglet, si disponible.

- -

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

- -

Syntaxe

- -
var  withgoingBack = browser.tabs.goBack(
-  tabId,                  // optional integer
-  callback                  // optional function
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet à naviguer. Par défaut, l'onglet actif de la fenêtre en cours.
-
callback{{optional_inline}}
-
function. Lorsque la navigation sur la page se termine, cette fonction est appelée sans paramètres.
-
- -

Valeur retournée

- -

Une Promise qui est tenue lorsque la navigation sur la page se termine.

- -

Compatibilité du navigateur

- - - -

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

- -

Exemples

- -

Retournez à la page précédente dans l'onglet en cours :

- -
function onGoBack() {
-  console.log("Gone back");
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var goingBack = browser.tabs.goBack();
-goingBack.then(onGoBack, onError);
- -

{{WebExtExamples}}

- -

Note :

- -

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

- -

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence américaine Creative Commons Attribution 3.0.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md new file mode 100644 index 0000000000..f0c2dc8c64 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/goback/index.md @@ -0,0 +1,101 @@ +--- +title: tabs.goBack() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/goBack +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - hoBack +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/goBack +--- +
{{AddonSidebar()}}
+ +

Naviguer à la page précédente dans l'historique de l'onglet, si disponible.

+ +

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

+ +

Syntaxe

+ +
var  withgoingBack = browser.tabs.goBack(
+  tabId,                  // optional integer
+  callback                  // optional function
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet à naviguer. Par défaut, l'onglet actif de la fenêtre en cours.
+
callback{{optional_inline}}
+
function. Lorsque la navigation sur la page se termine, cette fonction est appelée sans paramètres.
+
+ +

Valeur retournée

+ +

Une Promise qui est tenue lorsque la navigation sur la page se termine.

+ +

Compatibilité du navigateur

+ + + +

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

+ +

Exemples

+ +

Retournez à la page précédente dans l'onglet en cours :

+ +
function onGoBack() {
+  console.log("Gone back");
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var goingBack = browser.tabs.goBack();
+goingBack.then(onGoBack, onError);
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+ +

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence américaine Creative Commons Attribution 3.0.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.html deleted file mode 100644 index fce5647bc7..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: tabs.goForward() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/goForward -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - goForward -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/goForward ---- -
{{AddonSidebar()}}
- -

Passez à la page suivante dans l'historique de l'onglet, si disponible.

- -

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

- -

Syntaxe

- -
var goingForward = browser.tabs.goForward(
-  tabId,                       // optional integer
-  callback                     // optional function
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet à naviguer. Par défaut, l'onglet actif de la fenêtre en cours.
-
callback{{optional_inline}}
-
function. Lorsque la navigation sur la page se termine, cette fonction est appelée sans paramètres.
-
- -

Valeur retournée

- -

Une Promise qui est tenue lorsque la navigation sur la page se termine.

- -

Compatibilité du navigateur

- - - -

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

- -

Exemples

- -

Passez à la page suivante dans l'onglet en cours :

- -
function onGoForward() {
-  console.log("Gone forward");
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var goingForward = browser.tabs.goForward();
-goingForward.then(onGoForward, onError);
- -

{{WebExtExamples}}

- -

Note :

- -

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

- -

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence américaine Creative Commons Attribution 3.0.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md new file mode 100644 index 0000000000..fce5647bc7 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/goforward/index.md @@ -0,0 +1,101 @@ +--- +title: tabs.goForward() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/goForward +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - goForward +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/goForward +--- +
{{AddonSidebar()}}
+ +

Passez à la page suivante dans l'historique de l'onglet, si disponible.

+ +

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

+ +

Syntaxe

+ +
var goingForward = browser.tabs.goForward(
+  tabId,                       // optional integer
+  callback                     // optional function
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet à naviguer. Par défaut, l'onglet actif de la fenêtre en cours.
+
callback{{optional_inline}}
+
function. Lorsque la navigation sur la page se termine, cette fonction est appelée sans paramètres.
+
+ +

Valeur retournée

+ +

Une Promise qui est tenue lorsque la navigation sur la page se termine.

+ +

Compatibilité du navigateur

+ + + +

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

+ +

Exemples

+ +

Passez à la page suivante dans l'onglet en cours :

+ +
function onGoForward() {
+  console.log("Gone forward");
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var goingForward = browser.tabs.goForward();
+goingForward.then(onGoForward, onError);
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+ +

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence américaine Creative Commons Attribution 3.0.

+
+ + 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 deleted file mode 100644 index 5686440252..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -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")}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md new file mode 100644 index 0000000000..5686440252 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/hide/index.md @@ -0,0 +1,87 @@ +--- +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")}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.html deleted file mode 100644 index f96c75b883..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.html +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: tabs.highlight() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/highlight -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - highlight - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/highlight ---- -
{{AddonSidebar()}}
- -
Met en évidence (sélectionné) un ou plusieurs onglets. Les onglets sont spécifiés à l'aide d'un identifiant de fenêtre et d'une plage d'indices de tabulation.
- -
- -
-

C'est une fonction asynchrone qui renvoie une Promise.

-
- -

Syntaxe

- -
var highlighting = browser.tabs.highlight(
-  highlightInfo         // object
-)
-
- -

Paramètres

- -
-
highlightInfo
-

object.

-
-
windowId{{optional_inline}}
-
integer. ID de la fenêtre contenant les onglets.
-
populate{{optional_inline}}
-

boolean. Par défaut la valeur est true. S'il est défini sur false, l'objet {{WebExtAPIRef('windows.Window')}} n'aura pas de propriété tabs contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} représentant les onglets ouverts dans la fenêtre.

-
-

Note : Remplir la fenêtre (le comportement par défaut) peut être une opération coûteuse s'il y a beaucoup d'onglets. Pour de meilleures performances, il est recommandé de définir manuellement configuré populate à false si vous n'avez pas besoin des détails de l'onglet.

-
-
-
tabs
-
array de valeurs entières spécifiant un ou plusieurs onglets à mettre en évidence. Les onglets surlignés précédemment qui ne sont pas inclus dans les onglets cesseront d'être surlignés. Le premier onglet des onglets devient actif.
-
-
-
- -

Valeur retournée

- -

Une Promise  qui sera remplie avec un objet  {{WebExtAPIRef('windows.Window')}} contenant des détails sur la fenêtre dont les onglets ont été mis en surbrillance. Si la fenêtre n'a pas pu être trouvée ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.highlight",2)}}

- -

{{WebExtExamples}}

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md new file mode 100644 index 0000000000..f96c75b883 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/highlight/index.md @@ -0,0 +1,99 @@ +--- +title: tabs.highlight() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/highlight +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - highlight + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/highlight +--- +
{{AddonSidebar()}}
+ +
Met en évidence (sélectionné) un ou plusieurs onglets. Les onglets sont spécifiés à l'aide d'un identifiant de fenêtre et d'une plage d'indices de tabulation.
+ +
+ +
+

C'est une fonction asynchrone qui renvoie une Promise.

+
+ +

Syntaxe

+ +
var highlighting = browser.tabs.highlight(
+  highlightInfo         // object
+)
+
+ +

Paramètres

+ +
+
highlightInfo
+

object.

+
+
windowId{{optional_inline}}
+
integer. ID de la fenêtre contenant les onglets.
+
populate{{optional_inline}}
+

boolean. Par défaut la valeur est true. S'il est défini sur false, l'objet {{WebExtAPIRef('windows.Window')}} n'aura pas de propriété tabs contenant une liste d'objets {{WebExtAPIRef('tabs.Tab')}} représentant les onglets ouverts dans la fenêtre.

+
+

Note : Remplir la fenêtre (le comportement par défaut) peut être une opération coûteuse s'il y a beaucoup d'onglets. Pour de meilleures performances, il est recommandé de définir manuellement configuré populate à false si vous n'avez pas besoin des détails de l'onglet.

+
+
+
tabs
+
array de valeurs entières spécifiant un ou plusieurs onglets à mettre en évidence. Les onglets surlignés précédemment qui ne sont pas inclus dans les onglets cesseront d'être surlignés. Le premier onglet des onglets devient actif.
+
+
+
+ +

Valeur retournée

+ +

Une Promise  qui sera remplie avec un objet  {{WebExtAPIRef('windows.Window')}} contenant des détails sur la fenêtre dont les onglets ont été mis en surbrillance. Si la fenêtre n'a pas pu être trouvée ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.highlight",2)}}

+ +

{{WebExtExamples}}

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.html deleted file mode 100644 index cfea5b78c9..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/index.html +++ /dev/null @@ -1,223 +0,0 @@ ---- -title: tabs -slug: Mozilla/Add-ons/WebExtensions/API/tabs -tags: - - API - - Add-ons - - Extensions - - Interface - - NeedsTranslation - - Non-standard - - Reference - - TopicStub - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs ---- -
{{AddonSidebar}}
- -

Permet d'interagir avec le système d'onglets du navigateur.

- -

Vous pouvez utiliser cette API pour obtenir une liste des onglets ouverts, filtrés par différents critères, ainsi que pour ouvrir, mettre à jour, déplacer, recharger et supprimer des onglets. Vous ne pouvez pas accéder directement au contenu hébergé par les onglets à l'aide de cette API, mais vous pouvez insérer du JavaScript et du CSS dans les onglets en utilisant les API {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}.

- -

Vous pouvez utiliser la majeure partie de cette API sans autorisation spéciale. Toutefois :

- - - -

Alternativement, vous pouvez obtenir ces autorisations temporairement, uniquement pour l'onglet actuellement actif et uniquement en réponse à une action explicite de l'utilisateur ou de l'utilisatrice, en demandant la permission "activeTab".

- -

De nombreuses opérations d'onglet utilisent un identifiant (id) d'onglet. Les id d'onglets sont seulement garantis uniques à un onglet durant une session de navigation. Si le navigateur est redémarré, il pourra recycler, et recyclera, les id d'onglets. Pour associer des informations à un onglet à travers les redémarrages du navigateur, utilisez {{WebExtAPIRef("sessions.setTabValue()")}}.

- -

Types

- -
-
{{WebExtAPIRef("tabs.MutedInfoReason")}}
-
Spécifie la raison pour laquelle un onglet a été rendu silencieux ou à nouveau sonore.
-
{{WebExtAPIRef("tabs.MutedInfo")}}
-
Cet objet contient un booléen indiquant si l'onglet est silencieux et la raison de la dernière modification de l'état.
-
{{WebExtAPIRef("tabs.PageSettings")}}
-
-

Permet de contrôler le rendu d'un onglet au format PDF par la méthode {{WebExtAPIRef("tabs.saveAsPDF()")}}.

-
-
{{WebExtAPIRef("tabs.Tab")}}
-
Ce type contient des informations sur un onglet.
-
{{WebExtAPIRef("tabs.TabStatus")}}
-
Indique si l'onglet a fini de charger.
-
{{WebExtAPIRef("tabs.WindowType")}}
-
Le type de fenêtre qui héberge cet onglet.
-
{{WebExtAPIRef("tabs.ZoomSettingsMode")}}
-
Définit si les modifications de zoom sont traitées par le navigateur, par l'extension ou sont désactivées.
-
{{WebExtAPIRef("tabs.ZoomSettingsScope")}}
-
Définit si les modifications de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet.
-
{{WebExtAPIRef("tabs.ZoomSettings")}}
-
Définit les paramètres de zoom {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par défaut.
-
- -

Propriétés

- -
-
{{WebExtAPIRef("tabs.TAB_ID_NONE")}}
-
Une valeur d'id spéciale donnée aux onglets qui ne sont pas des onglets de navigation (par exemple, les onglets dans les fenêtres devtools).
-
- -

Fonctions

- -
-
{{WebExtAPIRef("tabs.captureTab()")}}
-
Crée un URI de données codant une image de la zone visible de l'onglet donné.
-
{{WebExtAPIRef("tabs.captureVisibleTab()")}}
-
Crée un URI de données codant une image de la zone visible de l'onglet actuellement actif dans la fenêtre donnée.
-
{{WebExtAPIRef("tabs.connect()")}}
-
Définit une connexion pour échanger des messages entre les scripts d'arrière-plan de l'extension (ou d'autres scripts privilégiés, tels que les scripts de popups ou les scripts de page d'options) et les scripts de contenu s'exécutant dans l'onglet spécifié.
-
{{WebExtAPIRef("tabs.create()")}}
-
Crée un nouvel onglet.
-
{{WebExtAPIRef("tabs.detectLanguage()")}}
-
Détecte la langue principale du contenu dans un onglet.
-
{{WebExtAPIRef("tabs.discard()")}}
-
Évince un ou plusieurs onglets.
-
{{WebExtAPIRef("tabs.duplicate()")}}
-
Duplique un onglet.
-
{{WebExtAPIRef("tabs.executeScript()")}}
-
Injecte du code JavaScript dans une page.
-
{{WebExtAPIRef("tabs.get()")}}
-
Obtient des détails sur l'onglet spécifié.
-
{{WebExtAPIRef("tabs.getAllInWindow()")}} {{deprecated_inline}}
-
Obtient des détails sur tous les onglets de la fenêtre spécifiée.
-
{{WebExtAPIRef("tabs.getCurrent()")}}
-
Obtient des informations sur l'onglet dans lequel ce script s'exécute, en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}.
-
{{WebExtAPIRef("tabs.getSelected()")}} {{deprecated_inline}}
-
Obtient l'onglet sélectionné dans la fenêtre spécifiée. Deprecated: utilisez plutôt tabs.query({active: true}).
-
{{WebExtAPIRef("tabs.getZoom()")}}
-
Obtient le facteur de zoom actuel de l'onglet spécifié.
-
{{WebExtAPIRef("tabs.getZoomSettings()")}}
-
Obtient les paramètres de zoom actuels pour l'onglet spécifié.
-
{{WebExtAPIRef("tabs.goForward()")}}
-
Passez à la page suivante, si vous en avez une.
-
{{WebExtAPIRef("tabs.goBack()")}}
-
Retour à la page précédente, si elle est disponible.
-
{{WebExtAPIRef("tabs.hide()")}} {{experimental_inline}}
-
Masque un ou plusieurs onglets.
-
{{WebExtAPIRef("tabs.highlight()")}}
-
Met en évidence un ou plusieurs onglets.
-
{{WebExtAPIRef("tabs.insertCSS()")}}
-
Injecte CSS dans une page.
-
{{WebExtAPIRef("tabs.move()")}}
-
Déplace un ou plusieurs onglets vers une nouvelle position dans la même fenêtre ou vers une autre fenêtre.
-
{{WebExtApiRef("tabs.moveInSuccession()")}}
-
Modifie la relation de succession pour un groupe d'onglets.
-
{{WebExtAPIRef("tabs.print()")}}
-
Imprime le contenu de l'onglet actif.
-
{{WebExtAPIRef("tabs.printPreview()")}}
-
-
Ouvre l'aperçu avant impression pour l'onglet actif.
-
-
{{WebExtAPIRef("tabs.query()")}}
-
Obtient tous les onglets ayant les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.
-
{{WebExtAPIRef("tabs.reload()")}}
-
Recharge un onglet, en contournant éventuellement le cache web local.
-
{{WebExtAPIRef("tabs.remove()")}}
-
Ferme un ou plusieurs onglets.
-
{{WebExtAPIRef("tabs.removeCSS()")}}
-
Supprime d'une page CSS qui a été précédemment injectée en appelant {{WebExtAPIRef("tabs.insertCSS()")}}.
-
{{WebExtAPIRef("tabs.saveAsPDF()")}}
-
Enregistre la page en cours au format PDF.
-
{{WebExtAPIRef("tabs.sendMessage()")}}
-
Envoie un message unique au(x) script(s) de contenu dans l'onglet spécifié.
-
{{WebExtAPIRef("tabs.sendRequest()")}} {{deprecated_inline}}
-
Envoie une requête unique au(x) script(s) de contenu dans l'onglet spécifié. Déprécié : utilisez {{WebExtAPIRef("tabs.sendMessage()")}} à la place.
-
{{WebExtAPIRef("tabs.setZoom()")}}
-
Effectue un zoom sur l'onglet spécifié.
-
{{WebExtAPIRef("tabs.setZoomSettings()")}}
-
Définit les paramètres de zoom pour l'onglet spécifié.
-
{{WebExtAPIRef("tabs.show()")}} {{experimental_inline}}
-
Affiche un ou plusieurs onglets qui ont été {{WebExtAPIRef("tabs.hide()", "masqués")}}.
-
{{WebExtAPIRef("tabs.toggleReaderMode()")}}
-
Bascule en mode lecture pour l'onglet spécifié.
-
{{WebExtAPIRef("tabs.update()")}}
-
Charge une nouvelle URL dans l'onglet, ou modifie d'autres propriétés de l'onglet.
-
- -

Évènements

- -
-
{{WebExtAPIRef("tabs.onActivated")}}
-
Est émis lorsque l'onglet actif dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet évènement a été émis.
-
{{WebExtAPIRef("tabs.onActiveChanged")}} {{deprecated_inline}}
-
Est émis lorsque l'onglet sélectionné dans une fenêtre change. Déprécié : utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.
-
{{WebExtAPIRef("tabs.onAttached")}}
-
Est émis lorsqu'un onglet est attaché à une fenêtre, par exemple parce qu'il a été déplacé entre différentes fenêtres.
-
{{WebExtAPIRef("tabs.onCreated")}}
-
Est émis lorsqu'un onglet est créé. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet évènement a été émis.
-
{{WebExtAPIRef("tabs.onDetached")}}
-
Est émis lorsqu'un onglet est détaché d'une fenêtre, par exemple parce qu'il a été déplacé entre différentes fenêtres.
-
{{WebExtAPIRef("tabs.onHighlightChanged")}} {{deprecated_inline}}
-
Est émis lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent. Déprécié : utilisez {{WebExtAPIRef("tabs.onHighlighted")}} à la place.
-
{{WebExtAPIRef("tabs.onHighlighted")}}
-
Est émis lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent.
-
{{WebExtAPIRef("tabs.onMoved")}}
-
Est émis lorsqu'un onglet est déplacé dans une fenêtre.
-
{{WebExtAPIRef("tabs.onRemoved")}}
-
Est émis lorsqu'un onglet est fermé.
-
{{WebExtAPIRef("tabs.onReplaced")}}
-
Est émis lorsqu'un onglet est remplacé par un autre onglet en raison d'un prerendering.
-
{{WebExtAPIRef("tabs.onSelectionChanged")}} {{deprecated_inline}}
-
Est émis lorsque l'onglet sélectionné dans une fenêtre change. Déprécié : utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.
-
{{WebExtAPIRef("tabs.onUpdated")}}
-
Est émis lorsqu'un onglet est mis à jour.
-
{{WebExtAPIRef("tabs.onZoomChange")}}
-
Est émis lorsque le zoom dans un onglet est changé.
-
- -

Compatibilité des navigateurs

- -

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

- -

{{WebExtExamples("h2")}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.md new file mode 100644 index 0000000000..cfea5b78c9 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/index.md @@ -0,0 +1,223 @@ +--- +title: tabs +slug: Mozilla/Add-ons/WebExtensions/API/tabs +tags: + - API + - Add-ons + - Extensions + - Interface + - NeedsTranslation + - Non-standard + - Reference + - TopicStub + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs +--- +
{{AddonSidebar}}
+ +

Permet d'interagir avec le système d'onglets du navigateur.

+ +

Vous pouvez utiliser cette API pour obtenir une liste des onglets ouverts, filtrés par différents critères, ainsi que pour ouvrir, mettre à jour, déplacer, recharger et supprimer des onglets. Vous ne pouvez pas accéder directement au contenu hébergé par les onglets à l'aide de cette API, mais vous pouvez insérer du JavaScript et du CSS dans les onglets en utilisant les API {{WebExtAPIRef("tabs.executeScript()")}} ou {{WebExtAPIRef("tabs.insertCSS()")}}.

+ +

Vous pouvez utiliser la majeure partie de cette API sans autorisation spéciale. Toutefois :

+ + + +

Alternativement, vous pouvez obtenir ces autorisations temporairement, uniquement pour l'onglet actuellement actif et uniquement en réponse à une action explicite de l'utilisateur ou de l'utilisatrice, en demandant la permission "activeTab".

+ +

De nombreuses opérations d'onglet utilisent un identifiant (id) d'onglet. Les id d'onglets sont seulement garantis uniques à un onglet durant une session de navigation. Si le navigateur est redémarré, il pourra recycler, et recyclera, les id d'onglets. Pour associer des informations à un onglet à travers les redémarrages du navigateur, utilisez {{WebExtAPIRef("sessions.setTabValue()")}}.

+ +

Types

+ +
+
{{WebExtAPIRef("tabs.MutedInfoReason")}}
+
Spécifie la raison pour laquelle un onglet a été rendu silencieux ou à nouveau sonore.
+
{{WebExtAPIRef("tabs.MutedInfo")}}
+
Cet objet contient un booléen indiquant si l'onglet est silencieux et la raison de la dernière modification de l'état.
+
{{WebExtAPIRef("tabs.PageSettings")}}
+
+

Permet de contrôler le rendu d'un onglet au format PDF par la méthode {{WebExtAPIRef("tabs.saveAsPDF()")}}.

+
+
{{WebExtAPIRef("tabs.Tab")}}
+
Ce type contient des informations sur un onglet.
+
{{WebExtAPIRef("tabs.TabStatus")}}
+
Indique si l'onglet a fini de charger.
+
{{WebExtAPIRef("tabs.WindowType")}}
+
Le type de fenêtre qui héberge cet onglet.
+
{{WebExtAPIRef("tabs.ZoomSettingsMode")}}
+
Définit si les modifications de zoom sont traitées par le navigateur, par l'extension ou sont désactivées.
+
{{WebExtAPIRef("tabs.ZoomSettingsScope")}}
+
Définit si les modifications de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet.
+
{{WebExtAPIRef("tabs.ZoomSettings")}}
+
Définit les paramètres de zoom {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par défaut.
+
+ +

Propriétés

+ +
+
{{WebExtAPIRef("tabs.TAB_ID_NONE")}}
+
Une valeur d'id spéciale donnée aux onglets qui ne sont pas des onglets de navigation (par exemple, les onglets dans les fenêtres devtools).
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("tabs.captureTab()")}}
+
Crée un URI de données codant une image de la zone visible de l'onglet donné.
+
{{WebExtAPIRef("tabs.captureVisibleTab()")}}
+
Crée un URI de données codant une image de la zone visible de l'onglet actuellement actif dans la fenêtre donnée.
+
{{WebExtAPIRef("tabs.connect()")}}
+
Définit une connexion pour échanger des messages entre les scripts d'arrière-plan de l'extension (ou d'autres scripts privilégiés, tels que les scripts de popups ou les scripts de page d'options) et les scripts de contenu s'exécutant dans l'onglet spécifié.
+
{{WebExtAPIRef("tabs.create()")}}
+
Crée un nouvel onglet.
+
{{WebExtAPIRef("tabs.detectLanguage()")}}
+
Détecte la langue principale du contenu dans un onglet.
+
{{WebExtAPIRef("tabs.discard()")}}
+
Évince un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.duplicate()")}}
+
Duplique un onglet.
+
{{WebExtAPIRef("tabs.executeScript()")}}
+
Injecte du code JavaScript dans une page.
+
{{WebExtAPIRef("tabs.get()")}}
+
Obtient des détails sur l'onglet spécifié.
+
{{WebExtAPIRef("tabs.getAllInWindow()")}} {{deprecated_inline}}
+
Obtient des détails sur tous les onglets de la fenêtre spécifiée.
+
{{WebExtAPIRef("tabs.getCurrent()")}}
+
Obtient des informations sur l'onglet dans lequel ce script s'exécute, en tant qu'objet {{WebExtAPIRef("tabs.Tab")}}.
+
{{WebExtAPIRef("tabs.getSelected()")}} {{deprecated_inline}}
+
Obtient l'onglet sélectionné dans la fenêtre spécifiée. Deprecated: utilisez plutôt tabs.query({active: true}).
+
{{WebExtAPIRef("tabs.getZoom()")}}
+
Obtient le facteur de zoom actuel de l'onglet spécifié.
+
{{WebExtAPIRef("tabs.getZoomSettings()")}}
+
Obtient les paramètres de zoom actuels pour l'onglet spécifié.
+
{{WebExtAPIRef("tabs.goForward()")}}
+
Passez à la page suivante, si vous en avez une.
+
{{WebExtAPIRef("tabs.goBack()")}}
+
Retour à la page précédente, si elle est disponible.
+
{{WebExtAPIRef("tabs.hide()")}} {{experimental_inline}}
+
Masque un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.highlight()")}}
+
Met en évidence un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.insertCSS()")}}
+
Injecte CSS dans une page.
+
{{WebExtAPIRef("tabs.move()")}}
+
Déplace un ou plusieurs onglets vers une nouvelle position dans la même fenêtre ou vers une autre fenêtre.
+
{{WebExtApiRef("tabs.moveInSuccession()")}}
+
Modifie la relation de succession pour un groupe d'onglets.
+
{{WebExtAPIRef("tabs.print()")}}
+
Imprime le contenu de l'onglet actif.
+
{{WebExtAPIRef("tabs.printPreview()")}}
+
+
Ouvre l'aperçu avant impression pour l'onglet actif.
+
+
{{WebExtAPIRef("tabs.query()")}}
+
Obtient tous les onglets ayant les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.
+
{{WebExtAPIRef("tabs.reload()")}}
+
Recharge un onglet, en contournant éventuellement le cache web local.
+
{{WebExtAPIRef("tabs.remove()")}}
+
Ferme un ou plusieurs onglets.
+
{{WebExtAPIRef("tabs.removeCSS()")}}
+
Supprime d'une page CSS qui a été précédemment injectée en appelant {{WebExtAPIRef("tabs.insertCSS()")}}.
+
{{WebExtAPIRef("tabs.saveAsPDF()")}}
+
Enregistre la page en cours au format PDF.
+
{{WebExtAPIRef("tabs.sendMessage()")}}
+
Envoie un message unique au(x) script(s) de contenu dans l'onglet spécifié.
+
{{WebExtAPIRef("tabs.sendRequest()")}} {{deprecated_inline}}
+
Envoie une requête unique au(x) script(s) de contenu dans l'onglet spécifié. Déprécié : utilisez {{WebExtAPIRef("tabs.sendMessage()")}} à la place.
+
{{WebExtAPIRef("tabs.setZoom()")}}
+
Effectue un zoom sur l'onglet spécifié.
+
{{WebExtAPIRef("tabs.setZoomSettings()")}}
+
Définit les paramètres de zoom pour l'onglet spécifié.
+
{{WebExtAPIRef("tabs.show()")}} {{experimental_inline}}
+
Affiche un ou plusieurs onglets qui ont été {{WebExtAPIRef("tabs.hide()", "masqués")}}.
+
{{WebExtAPIRef("tabs.toggleReaderMode()")}}
+
Bascule en mode lecture pour l'onglet spécifié.
+
{{WebExtAPIRef("tabs.update()")}}
+
Charge une nouvelle URL dans l'onglet, ou modifie d'autres propriétés de l'onglet.
+
+ +

Évènements

+ +
+
{{WebExtAPIRef("tabs.onActivated")}}
+
Est émis lorsque l'onglet actif dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet évènement a été émis.
+
{{WebExtAPIRef("tabs.onActiveChanged")}} {{deprecated_inline}}
+
Est émis lorsque l'onglet sélectionné dans une fenêtre change. Déprécié : utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.
+
{{WebExtAPIRef("tabs.onAttached")}}
+
Est émis lorsqu'un onglet est attaché à une fenêtre, par exemple parce qu'il a été déplacé entre différentes fenêtres.
+
{{WebExtAPIRef("tabs.onCreated")}}
+
Est émis lorsqu'un onglet est créé. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet évènement a été émis.
+
{{WebExtAPIRef("tabs.onDetached")}}
+
Est émis lorsqu'un onglet est détaché d'une fenêtre, par exemple parce qu'il a été déplacé entre différentes fenêtres.
+
{{WebExtAPIRef("tabs.onHighlightChanged")}} {{deprecated_inline}}
+
Est émis lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent. Déprécié : utilisez {{WebExtAPIRef("tabs.onHighlighted")}} à la place.
+
{{WebExtAPIRef("tabs.onHighlighted")}}
+
Est émis lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent.
+
{{WebExtAPIRef("tabs.onMoved")}}
+
Est émis lorsqu'un onglet est déplacé dans une fenêtre.
+
{{WebExtAPIRef("tabs.onRemoved")}}
+
Est émis lorsqu'un onglet est fermé.
+
{{WebExtAPIRef("tabs.onReplaced")}}
+
Est émis lorsqu'un onglet est remplacé par un autre onglet en raison d'un prerendering.
+
{{WebExtAPIRef("tabs.onSelectionChanged")}} {{deprecated_inline}}
+
Est émis lorsque l'onglet sélectionné dans une fenêtre change. Déprécié : utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.
+
{{WebExtAPIRef("tabs.onUpdated")}}
+
Est émis lorsqu'un onglet est mis à jour.
+
{{WebExtAPIRef("tabs.onZoomChange")}}
+
Est émis lorsque le zoom dans un onglet est changé.
+
+ +

Compatibilité des navigateurs

+ +

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

+ +

{{WebExtExamples("h2")}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.html deleted file mode 100644 index d51ca99171..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.html +++ /dev/null @@ -1,141 +0,0 @@ ---- -title: tabs.insertCSS() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - insertCSS - - onglets - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS ---- -
{{AddonSidebar()}}
- -

Injecter du code CSS dans une page web.

- -

Pour utiliser cette API vous devez avoir la permission "host permission" ou utiliser la permission "activeTab permission".

- -

Vous ne pouvez injecter du CSS que dans des pages dont l'URL peut être exprimée en utilisant un motif de correspondance,  ce qui signifie que son schéma doit être "http", "https", "file", "ftp". Cela signifie que vous ne pouvez pas injecter de CSS dans les pages intégrées du navigateur, telles que about:debugging, about:addons, ou la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide.

- -
-

Note : Firefox résout les URL dans les fichiers CSS injectés par rapport au fichier CSS lui-même, plutôt qu'à la page dans laquelle il est injecté.

-
- -

Le CSS inséré peut être retiré à nouveau en appelant  {{WebExtAPIRef("tabs.removeCSS()")}}.

- -

C'est une fonction asynchrone qui renvoie une Promise (sur Firefox seulement).

- -

Syntaxe

- -
var inserting = browser.tabs.insertCSS(
-  tabId,           // optional integer
-  details          // object
-)
-
- -

Paramètres

- -
-
tabId {{optional_inline}}
-
integer. L'ID de l'onglet dans lequel insérer le CSS. Par défaut à l'onglet actif de la fenêtre en cours.
-
details
-

Un objet décrivant le CSS à insérer. Il contient les propriétés suivantes :

-
-
allFrames{{optional_inline}}
-
boolean. Si true, le CSS sera injecté dans toutes les images de la page en cours. Si c'est false, CSS est seulement injecté dans le cadre supérieur. Par défaut à false.
-
code{{optional_inline}}
-
string. Code à injecter, sous la forme d'une chaîne de texte.
-
cssOrigin{{optional_inline}}
-
string. Cela peut prendre l'une des deux valeurs suivantes: "utilisateur", pour ajouter le CSS en tant que feuille de style utilisateur, ou "auteur" pour l'ajouter en tant que feuille de style auteur. Spécifier "utilisateur" vous permet d'empêcher les sites Web de surcharger le CSS que vous insérez: voir la commande en cascade. Si cette option est omise, le CSS est ajouté en tant que feuille de style auteur.
-
file{{optional_inline}}
-
string. Chemin d'accès à un fichier contenant le code à injecter. Dans Firefox, les URL relatives sont résolues par rapport à l'URL de la page en cours. Dans Chrome, ces URL sont résolues par rapport à l'URL de base de l'extension. Pour travailler avec plusieurs navigateurs, vous pouvez spécifier le chemin comme une URL absolue, en commençant à la racine de l'extension, comme ceci : "/path/to/stylesheet.css".
-
frameId{{optional_inline}}
-
integer. Le cadre où le CSS doit être injecté. La valeur par défaut est 0 (l'image de niveau supérieur).
-
matchAboutBlank{{optional_inline}}
-
boolean. Sitrue, le code sera injecté dans les cadres "about:blank" et "about:srcdoc" intégrés si votre extension a accès à leur document parent. Le code ne peut pas être inséré au niveau supérieur about: frames. Par défaut à false.
-
runAt{{optional_inline}}
-
{{WebExtAPIRef('extensionTypes.RunAt')}}. Le plus tôt que le code sera injecté dans l'onglet. Par défaut à "document_idle".
-
-
-
- -

Valeur retournée

- -

Une Promise qui sera remplie sans arguments lorsque tous les CSS ont été insérés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Cet exemple s'insère dans l'onglet CSS actif qui provient d'une chaîne.

- -
var css = "body { border: 20px dotted pink; }";
-
-browser.browserAction.onClicked.addListener(() => {
-
-  function onError(error) {
-    console.log(`Error: ${error}`);
-  }
-
-  var insertingCSS = browser.tabs.insertCSS({code: css});
-  insertingCSS.then(null, onError);
-});
- -

Cet exemple insère CSS qui est chargé à partir d'un fichier empaqueté avec l'extension. Le CSS est inséré dans l'onglet dont l'identifiant est 2 :

- -
browser.browserAction.onClicked.addListener(() => {
-
-  function onError(error) {
-    console.log(`Error: ${error}`);
-  }
-
-  var insertingCSS = browser.tabs.insertCSS(2, {file: "content-style.css"});
-  insertingCSS.then(null, onError);
-});
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md new file mode 100644 index 0000000000..d51ca99171 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/insertcss/index.md @@ -0,0 +1,141 @@ +--- +title: tabs.insertCSS() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - insertCSS + - onglets + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/insertCSS +--- +
{{AddonSidebar()}}
+ +

Injecter du code CSS dans une page web.

+ +

Pour utiliser cette API vous devez avoir la permission "host permission" ou utiliser la permission "activeTab permission".

+ +

Vous ne pouvez injecter du CSS que dans des pages dont l'URL peut être exprimée en utilisant un motif de correspondance,  ce qui signifie que son schéma doit être "http", "https", "file", "ftp". Cela signifie que vous ne pouvez pas injecter de CSS dans les pages intégrées du navigateur, telles que about:debugging, about:addons, ou la page qui s'ouvre lorsque vous ouvrez un nouvel onglet vide.

+ +
+

Note : Firefox résout les URL dans les fichiers CSS injectés par rapport au fichier CSS lui-même, plutôt qu'à la page dans laquelle il est injecté.

+
+ +

Le CSS inséré peut être retiré à nouveau en appelant  {{WebExtAPIRef("tabs.removeCSS()")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise (sur Firefox seulement).

+ +

Syntaxe

+ +
var inserting = browser.tabs.insertCSS(
+  tabId,           // optional integer
+  details          // object
+)
+
+ +

Paramètres

+ +
+
tabId {{optional_inline}}
+
integer. L'ID de l'onglet dans lequel insérer le CSS. Par défaut à l'onglet actif de la fenêtre en cours.
+
details
+

Un objet décrivant le CSS à insérer. Il contient les propriétés suivantes :

+
+
allFrames{{optional_inline}}
+
boolean. Si true, le CSS sera injecté dans toutes les images de la page en cours. Si c'est false, CSS est seulement injecté dans le cadre supérieur. Par défaut à false.
+
code{{optional_inline}}
+
string. Code à injecter, sous la forme d'une chaîne de texte.
+
cssOrigin{{optional_inline}}
+
string. Cela peut prendre l'une des deux valeurs suivantes: "utilisateur", pour ajouter le CSS en tant que feuille de style utilisateur, ou "auteur" pour l'ajouter en tant que feuille de style auteur. Spécifier "utilisateur" vous permet d'empêcher les sites Web de surcharger le CSS que vous insérez: voir la commande en cascade. Si cette option est omise, le CSS est ajouté en tant que feuille de style auteur.
+
file{{optional_inline}}
+
string. Chemin d'accès à un fichier contenant le code à injecter. Dans Firefox, les URL relatives sont résolues par rapport à l'URL de la page en cours. Dans Chrome, ces URL sont résolues par rapport à l'URL de base de l'extension. Pour travailler avec plusieurs navigateurs, vous pouvez spécifier le chemin comme une URL absolue, en commençant à la racine de l'extension, comme ceci : "/path/to/stylesheet.css".
+
frameId{{optional_inline}}
+
integer. Le cadre où le CSS doit être injecté. La valeur par défaut est 0 (l'image de niveau supérieur).
+
matchAboutBlank{{optional_inline}}
+
boolean. Sitrue, le code sera injecté dans les cadres "about:blank" et "about:srcdoc" intégrés si votre extension a accès à leur document parent. Le code ne peut pas être inséré au niveau supérieur about: frames. Par défaut à false.
+
runAt{{optional_inline}}
+
{{WebExtAPIRef('extensionTypes.RunAt')}}. Le plus tôt que le code sera injecté dans l'onglet. Par défaut à "document_idle".
+
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans arguments lorsque tous les CSS ont été insérés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Cet exemple s'insère dans l'onglet CSS actif qui provient d'une chaîne.

+ +
var css = "body { border: 20px dotted pink; }";
+
+browser.browserAction.onClicked.addListener(() => {
+
+  function onError(error) {
+    console.log(`Error: ${error}`);
+  }
+
+  var insertingCSS = browser.tabs.insertCSS({code: css});
+  insertingCSS.then(null, onError);
+});
+ +

Cet exemple insère CSS qui est chargé à partir d'un fichier empaqueté avec l'extension. Le CSS est inséré dans l'onglet dont l'identifiant est 2 :

+ +
browser.browserAction.onClicked.addListener(() => {
+
+  function onError(error) {
+    console.log(`Error: ${error}`);
+  }
+
+  var insertingCSS = browser.tabs.insertCSS(2, {file: "content-style.css"});
+  insertingCSS.then(null, onError);
+});
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.html deleted file mode 100644 index 4e2d2605a9..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: tabs.move() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/move -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - deplacer - - move - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/move ---- -
{{AddonSidebar()}}
- -

Déplace un ou plusieurs onglets vers une nouvelle position dans la même fenêtre ou vers une autre fenêtre.

- -

Vous pouvez uniquement déplacer des onglets vers et à partir de fenêtres dont {{WebExtAPIRef('windows.WindowType', 'WindowType')}} est "normal".

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var moving = browser.tabs.move(
-  tabIds,              // integer or integer array
-  moveProperties       // object
-)
-
- -

Paramètres

- -
-
tabIds
-
integer ou array d'integer. ID du {{WebExtAPIRef('tabs.Tab', 'tab')}}à déplacer, ou un tableau d'ID d'onglet.
-
moveProperties
-

object. Un objet qui spécifie où déplacer le(s) onglet(s).

-
-
windowId{{optional_inline}}
-
integer. 'ID de la fenêtre dans laquelle vous souhaitez déplacer les onglet(s). Si vous omettez cela, chaque onglet de tabIds sera déplacé vers l' index dans sa fenêtre actuelle. Si vous incluez ceci, et tabIds contient plus d'un onglet, alors le premier onglet de tabIds sera déplacé vers l'index, et les autres onglets le suivront dans l'ordre donné dans tabIds.
-
index
-

integer. La position de l'index pour déplacer la tabulation à, en commençant à 0. Une valeur de -1 placera la tabulation à la fin de la fenêtre.

-

Si vous passez une valeur inférieure à -1, la fonction renvoie une erreur.

-

Notez que vous ne pouvez pas déplacer les onglets épinglés sur une position après les onglets non épinglés d'une fenêtre, ou déplacer les onglets non épinglés à une position avant les onglets épinglés. Par exemple, si vous avez un ou plusieurs onglets épinglés dans la fenêtre cible et si tabIds fait référence à un onglet non épinglé, vous ne pouvez pas passer 0 ici. Si vous essayez de le faire, la fonction échouera silencieusement (elle ne produira pas d'erreur).

-
-
-
-
- -

Valeur retournée

- -

Une Promise qui sera satisfaite avec un objet {{WebExtAPIRef('tabs.Tab')}} ou un tableau d'objets {{WebExtAPIRef('tabs.Tab')}}, contenant des détails sur les onglets déplacés. Si aucun onglet n'a été déplacé (par exemple, parce que vous avez essayé de déplacer un onglet non épinglé avant un onglet épinglé), il s'agira d'un tableau vide. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Déplacer le premier onglet de la fenêtre en cours vers la dernière position de la fenêtre en cours :

- -
function onMoved(tab) {
-  console.log(`Moved: ${tab}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function firstToLast(windowInfo) {
-  if (windowInfo.tabs.length == 0) {
-    return;
-  }
-  var moving = browser.tabs.move(windowInfo.tabs[0].id, {index: -1});
-  moving.then(onMoved, onError);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var gettingCurrent = browser.windows.getCurrent({populate: true});
-  gettingCurrent.then(firstToLast, onError);
-});
- -

Déplacer tous les onglets servis via HTTP ou HTTPS depuis * .mozilla.org jusqu'à la fin de leur fenêtre :

- -
function onMoved(tab) {
-  console.log(`Moved: ${tab}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function moveMoz(tabs) {
-  var mozTabIds = tabs.map(tabInfo => tabInfo.id);
-  var moving = browser.tabs.move(mozTabIds, {index: -1});
-  moving.then(onMoved, onError);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var gettingMozTabs = browser.tabs.query({url:"*://*.mozilla.org/*"});
-  gettingMozTabs.then(moveMoz, onError);
-});
- -

Déplacer tous les onglets servis via HTTP ou HTTPS de * .mozilla.org vers la fenêtre qui héberge le premier onglet de ce type, en commençant à la position 0 :

- -
function onMoved(tab) {
-  console.log(`Moved: ${tab}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function moveMoz(tabs) {
-  var mozTabIds = tabs.map(tabInfo => tabInfo.id);
-  var targetWindow = tabs[0].windowId;
-  var moving = browser.tabs.move(mozTabIds, {windowId: targetWindow, index: 0});
-  moving.then(onMoved, onError);
-}
-
-browser.browserAction.onClicked.addListener(function() {
-  var gettingMozTabs = browser.tabs.query({url:"*://*.mozilla.org/*"});
-  gettingMozTabs.then(moveMoz, onError);
-});
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md new file mode 100644 index 0000000000..4e2d2605a9 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/move/index.md @@ -0,0 +1,166 @@ +--- +title: tabs.move() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/move +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - deplacer + - move + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/move +--- +
{{AddonSidebar()}}
+ +

Déplace un ou plusieurs onglets vers une nouvelle position dans la même fenêtre ou vers une autre fenêtre.

+ +

Vous pouvez uniquement déplacer des onglets vers et à partir de fenêtres dont {{WebExtAPIRef('windows.WindowType', 'WindowType')}} est "normal".

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var moving = browser.tabs.move(
+  tabIds,              // integer or integer array
+  moveProperties       // object
+)
+
+ +

Paramètres

+ +
+
tabIds
+
integer ou array d'integer. ID du {{WebExtAPIRef('tabs.Tab', 'tab')}}à déplacer, ou un tableau d'ID d'onglet.
+
moveProperties
+

object. Un objet qui spécifie où déplacer le(s) onglet(s).

+
+
windowId{{optional_inline}}
+
integer. 'ID de la fenêtre dans laquelle vous souhaitez déplacer les onglet(s). Si vous omettez cela, chaque onglet de tabIds sera déplacé vers l' index dans sa fenêtre actuelle. Si vous incluez ceci, et tabIds contient plus d'un onglet, alors le premier onglet de tabIds sera déplacé vers l'index, et les autres onglets le suivront dans l'ordre donné dans tabIds.
+
index
+

integer. La position de l'index pour déplacer la tabulation à, en commençant à 0. Une valeur de -1 placera la tabulation à la fin de la fenêtre.

+

Si vous passez une valeur inférieure à -1, la fonction renvoie une erreur.

+

Notez que vous ne pouvez pas déplacer les onglets épinglés sur une position après les onglets non épinglés d'une fenêtre, ou déplacer les onglets non épinglés à une position avant les onglets épinglés. Par exemple, si vous avez un ou plusieurs onglets épinglés dans la fenêtre cible et si tabIds fait référence à un onglet non épinglé, vous ne pouvez pas passer 0 ici. Si vous essayez de le faire, la fonction échouera silencieusement (elle ne produira pas d'erreur).

+
+
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera satisfaite avec un objet {{WebExtAPIRef('tabs.Tab')}} ou un tableau d'objets {{WebExtAPIRef('tabs.Tab')}}, contenant des détails sur les onglets déplacés. Si aucun onglet n'a été déplacé (par exemple, parce que vous avez essayé de déplacer un onglet non épinglé avant un onglet épinglé), il s'agira d'un tableau vide. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Déplacer le premier onglet de la fenêtre en cours vers la dernière position de la fenêtre en cours :

+ +
function onMoved(tab) {
+  console.log(`Moved: ${tab}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function firstToLast(windowInfo) {
+  if (windowInfo.tabs.length == 0) {
+    return;
+  }
+  var moving = browser.tabs.move(windowInfo.tabs[0].id, {index: -1});
+  moving.then(onMoved, onError);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var gettingCurrent = browser.windows.getCurrent({populate: true});
+  gettingCurrent.then(firstToLast, onError);
+});
+ +

Déplacer tous les onglets servis via HTTP ou HTTPS depuis * .mozilla.org jusqu'à la fin de leur fenêtre :

+ +
function onMoved(tab) {
+  console.log(`Moved: ${tab}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function moveMoz(tabs) {
+  var mozTabIds = tabs.map(tabInfo => tabInfo.id);
+  var moving = browser.tabs.move(mozTabIds, {index: -1});
+  moving.then(onMoved, onError);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var gettingMozTabs = browser.tabs.query({url:"*://*.mozilla.org/*"});
+  gettingMozTabs.then(moveMoz, onError);
+});
+ +

Déplacer tous les onglets servis via HTTP ou HTTPS de * .mozilla.org vers la fenêtre qui héberge le premier onglet de ce type, en commençant à la position 0 :

+ +
function onMoved(tab) {
+  console.log(`Moved: ${tab}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function moveMoz(tabs) {
+  var mozTabIds = tabs.map(tabInfo => tabInfo.id);
+  var targetWindow = tabs[0].windowId;
+  var moving = browser.tabs.move(mozTabIds, {windowId: targetWindow, index: 0});
+  moving.then(onMoved, onError);
+}
+
+browser.browserAction.onClicked.addListener(function() {
+  var gettingMozTabs = browser.tabs.query({url:"*://*.mozilla.org/*"});
+  gettingMozTabs.then(moveMoz, onError);
+});
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.html deleted file mode 100644 index 261cb96adf..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: tabs.moveInSuccession() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/moveInSuccession -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - onglets - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/moveInSuccession ---- -

{{AddonSidebar()}}

- -

Modifie la relation de succession pour un groupe d'onglets.

- -

Using the {{WebExtAPIRef('tabs')}} API, a tab can be assigned a successor tab in the same window. If tab B is the successor of tab A, and tab A is closed while it is the active tab, tab B will be activated next. If tab A doesn't have a successor, then the browser is free to determine which tab to activate next. If tab B is the successor of tab A, then tab A is called a predecessor of tab B. A tab can have at most one successor, but it can have any number of predecessors. A tab cannot take itself or a tab in a different window as a successor.

- -

All tabs start out with no successor; tabs only get a successor if assigned one by a WebExtension. However, the browser must not orphan a tab in a succession relationship with other tabs, if possible: if tab B is the successor of tab A, and tab C is the successor of tab B, and B is closed (or moved to another window), then tab A will take tab C as its successor. Preventing C from being orphaned in this way is called moving a tab (B) from its line of succession.

- -

tabs.moveInSuccession() takes an array of tab IDs, and moves all of those tabs from their lines of succession. It then makes each tab the successor of the previous tab in the array, forming a chain. It can optionally set the successor of the last tab in the chain to an anchor tab, which is not moved from its line of succession. Additional options can control whether the tab chain is "prepended" or "appended" to the anchor tab, and whether the operation acts like a linked-list insert.

- -

While the successor tab can be assigned with {{WebExtAPIRef('tabs.update()')}}, it is often desirable to use tabs.moveInSuccession() to change successors, even if only a single tab is having its successor assigned. The difference is that browser.tabs.moveInSuccession([a], b) moves tab a from its line of succession, so any predecessors of a will adopt a's previous successor; whereas if browser.tabs.update(a, {successorTabId: b}) is used instead, tab a may continue to be the successor of other tabs, which could be unexpected. Another advantage of tabs.moveInSuccession() is that all of the succession changes happen atomically, without having to worry about races between calls to {{WebExtAPIRef('tabs.update()')}} and {{WebExtAPIRef('tabs.get()')}} and other operations like the user closing a tab.

- -

Syntaxe

- -
browser.tabs.moveInSuccession([1, 3, 5, 7, 2, 9], 4, {insert:true})
- -

Paramètres

- -
-
tabIds
-
array of integer. Un tableau  d'IDs. L'ordre des éléments dans le tableau définit la relation des onglets. Tout ID d'onglet invalide, ou l'ID d'onglet correspondant à des onglets qui ne sont pas dans la même fenêtre que tabId (ou le premier onglet du tableau, si  tabId est omis), sera ignoré - ils conserveront leurs successeurs et prédécesseurs actuels.
-
tabId {{optional_inline}}
-
integer. L'ID de l'onglet qui succédera au dernier onglet du tableau tabIds. Si cet ID est invalide ou {{WebExtAPIRef('tabs.TAB_ID_NONE')}}, le dernier onglet n'aura pas de successeur. Par défaut {{WebExtAPIRef('tabs.TAB_ID_NONE')}}.
-
options {{optional_inline}}
-

object.

-
-
append {{optional_inline}}
-
boolean. Détermine s'il faut déplacer les onglets dans les tabIds avant ou après tabId dans la succession. Si false, les onglets sont déplacés avant tabId, si true, les onglets sont déplacés après tabId. Par défaut à false.
-
insert {{optional_inline}}
-
boolean. Détermine s'il faut lier les prédécesseurs ou successeurs actuels (selon options.append) de tabIdà l'autre côté de la chaîne après son ajout ou son ajout. Si true, l'un des événements suivants se produit : si options.append est false, le premier onglet du tableau est défini comme successeur de tout prédécesseur actuel de  tabId; Si options.append est true, le successeur actuel de tabId est défini comme le successeur du dernier onglet du tableau. La valeur par défaut est false.
-
-
-
- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.moveInSuccession", 10)}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md new file mode 100644 index 0000000000..261cb96adf --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/moveinsuccession/index.md @@ -0,0 +1,51 @@ +--- +title: tabs.moveInSuccession() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/moveInSuccession +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - onglets + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/moveInSuccession +--- +

{{AddonSidebar()}}

+ +

Modifie la relation de succession pour un groupe d'onglets.

+ +

Using the {{WebExtAPIRef('tabs')}} API, a tab can be assigned a successor tab in the same window. If tab B is the successor of tab A, and tab A is closed while it is the active tab, tab B will be activated next. If tab A doesn't have a successor, then the browser is free to determine which tab to activate next. If tab B is the successor of tab A, then tab A is called a predecessor of tab B. A tab can have at most one successor, but it can have any number of predecessors. A tab cannot take itself or a tab in a different window as a successor.

+ +

All tabs start out with no successor; tabs only get a successor if assigned one by a WebExtension. However, the browser must not orphan a tab in a succession relationship with other tabs, if possible: if tab B is the successor of tab A, and tab C is the successor of tab B, and B is closed (or moved to another window), then tab A will take tab C as its successor. Preventing C from being orphaned in this way is called moving a tab (B) from its line of succession.

+ +

tabs.moveInSuccession() takes an array of tab IDs, and moves all of those tabs from their lines of succession. It then makes each tab the successor of the previous tab in the array, forming a chain. It can optionally set the successor of the last tab in the chain to an anchor tab, which is not moved from its line of succession. Additional options can control whether the tab chain is "prepended" or "appended" to the anchor tab, and whether the operation acts like a linked-list insert.

+ +

While the successor tab can be assigned with {{WebExtAPIRef('tabs.update()')}}, it is often desirable to use tabs.moveInSuccession() to change successors, even if only a single tab is having its successor assigned. The difference is that browser.tabs.moveInSuccession([a], b) moves tab a from its line of succession, so any predecessors of a will adopt a's previous successor; whereas if browser.tabs.update(a, {successorTabId: b}) is used instead, tab a may continue to be the successor of other tabs, which could be unexpected. Another advantage of tabs.moveInSuccession() is that all of the succession changes happen atomically, without having to worry about races between calls to {{WebExtAPIRef('tabs.update()')}} and {{WebExtAPIRef('tabs.get()')}} and other operations like the user closing a tab.

+ +

Syntaxe

+ +
browser.tabs.moveInSuccession([1, 3, 5, 7, 2, 9], 4, {insert:true})
+ +

Paramètres

+ +
+
tabIds
+
array of integer. Un tableau  d'IDs. L'ordre des éléments dans le tableau définit la relation des onglets. Tout ID d'onglet invalide, ou l'ID d'onglet correspondant à des onglets qui ne sont pas dans la même fenêtre que tabId (ou le premier onglet du tableau, si  tabId est omis), sera ignoré - ils conserveront leurs successeurs et prédécesseurs actuels.
+
tabId {{optional_inline}}
+
integer. L'ID de l'onglet qui succédera au dernier onglet du tableau tabIds. Si cet ID est invalide ou {{WebExtAPIRef('tabs.TAB_ID_NONE')}}, le dernier onglet n'aura pas de successeur. Par défaut {{WebExtAPIRef('tabs.TAB_ID_NONE')}}.
+
options {{optional_inline}}
+

object.

+
+
append {{optional_inline}}
+
boolean. Détermine s'il faut déplacer les onglets dans les tabIds avant ou après tabId dans la succession. Si false, les onglets sont déplacés avant tabId, si true, les onglets sont déplacés après tabId. Par défaut à false.
+
insert {{optional_inline}}
+
boolean. Détermine s'il faut lier les prédécesseurs ou successeurs actuels (selon options.append) de tabIdà l'autre côté de la chaîne après son ajout ou son ajout. Si true, l'un des événements suivants se produit : si options.append est false, le premier onglet du tableau est défini comme successeur de tout prédécesseur actuel de  tabId; Si options.append est true, le successeur actuel de tabId est défini comme le successeur du dernier onglet du tableau. La valeur par défaut est false.
+
+
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.moveInSuccession", 10)}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.html deleted file mode 100644 index 2c900b4551..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: tabs.MutedInfo -slug: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfo -tags: - - API - - Add-ons - - Extensions - - MutedInfo - - Non-standard - - Reference - - Type - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfo ---- -
{{AddonSidebar()}}
- -

Cet objet contient un booléen indiquant si l'onglet est muet et la raison du dernier changement d'état.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
extensionId{{optional_inline}}
-
string. L'ID de l'extension qui a modifié en dernier l'état muet. Non défini si une extension n'a pas été la raison pour laquelle l'état muet a été modifié pour la dernière fois.
-
muted
-
boolean. Si l'onglet est actuellement coupé. Équivalent à l'affichage de l'indicateur audio coupé.
-
reason{{optional_inline}}
-
{{WebExtAPIRef('tabs.MutedInfoReason')}}. La raison pour laquelle l'onglet a été désactivé ou désactivé. Non défini si l'état muet de l'onglet n'a jamais été modifié.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md new file mode 100644 index 0000000000..2c900b4551 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinfo/index.md @@ -0,0 +1,75 @@ +--- +title: tabs.MutedInfo +slug: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfo +tags: + - API + - Add-ons + - Extensions + - MutedInfo + - Non-standard + - Reference + - Type + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfo +--- +
{{AddonSidebar()}}
+ +

Cet objet contient un booléen indiquant si l'onglet est muet et la raison du dernier changement d'état.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
extensionId{{optional_inline}}
+
string. L'ID de l'extension qui a modifié en dernier l'état muet. Non défini si une extension n'a pas été la raison pour laquelle l'état muet a été modifié pour la dernière fois.
+
muted
+
boolean. Si l'onglet est actuellement coupé. Équivalent à l'affichage de l'indicateur audio coupé.
+
reason{{optional_inline}}
+
{{WebExtAPIRef('tabs.MutedInfoReason')}}. La raison pour laquelle l'onglet a été désactivé ou désactivé. Non défini si l'état muet de l'onglet n'a jamais été modifié.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.html deleted file mode 100644 index 1d1e71bcdb..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: tabs.MutedInfoReason -slug: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfoReason -tags: - - API - - Add-ons - - Extensions - - MutedInfoReason - - Non-standard - - Refrence - - Type - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfoReason ---- -
{{AddonSidebar()}}
- -

Spécifie la raison pour laquelle un onglet a été désactivé ou désactivé.

- -

Type

- -

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

- -
-
"capture"
-
La capture d'onglets a commencé, forçant un changement d'état muet.
-
"extension"
-
Une extension définit l'état muet. Si c'est la raison, extensionId dans {{WebExtAPIRef("tabs.mutedInfo")}} contiendra l'ID de l'extension responsable.
-
"user"
-
L'utilisateur définit l'état muet.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md new file mode 100644 index 0000000000..1d1e71bcdb --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/mutedinforeason/index.md @@ -0,0 +1,75 @@ +--- +title: tabs.MutedInfoReason +slug: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfoReason +tags: + - API + - Add-ons + - Extensions + - MutedInfoReason + - Non-standard + - Refrence + - Type + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/MutedInfoReason +--- +
{{AddonSidebar()}}
+ +

Spécifie la raison pour laquelle un onglet a été désactivé ou désactivé.

+ +

Type

+ +

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

+ +
+
"capture"
+
La capture d'onglets a commencé, forçant un changement d'état muet.
+
"extension"
+
Une extension définit l'état muet. Si c'est la raison, extensionId dans {{WebExtAPIRef("tabs.mutedInfo")}} contiendra l'ID de l'extension responsable.
+
"user"
+
L'utilisateur définit l'état muet.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.html deleted file mode 100644 index 8032a515ae..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: tabs.onActivated -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onActivated -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onActivated - - tavs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onActivated ---- -
{{AddonSidebar()}}
- -

Se déclenche lorsque l'onglet actif dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement s'est déclenché, mais vous pouvez écouter les événements {{WebExtAPIRef("tabs.onUpdated")}} pour être averti lorsqu'une URL est définie.

- -

Syntaxe

- -
browser.tabs.onActivated.addListener(listener)
-browser.tabs.onActivated.removeListener(listener)
-browser.tabs.onActivated.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 :

- -
-
activeInfo
-
object. ID de l'onglet qui a été activé, et ID de sa fenêtre.
-
-
-
- -

Objets supplémentaires

- -

activeInfo

- -
-
previousTabId
-
integer. L'ID de l'onglet activé précédent, si cet onglet est encore ouvert.
-
tabId
-
integer. L'ID de l'onglet qui est devenu actif.
-
windowId
-
integer. L'ID de la fenêtre de l'onglet.
-
- -

Exemples

- -

Écouter et enregistrer les événements d'activation des onglets :

- -
function handleActivated(activeInfo) {
-  console.log("Tab " + activeInfo.tabId +
-              " was activated");
-}
-
-browser.tabs.onActivated.addListener(handleActivated);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md new file mode 100644 index 0000000000..8032a515ae --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivated/index.md @@ -0,0 +1,118 @@ +--- +title: tabs.onActivated +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onActivated +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onActivated + - tavs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onActivated +--- +
{{AddonSidebar()}}
+ +

Se déclenche lorsque l'onglet actif dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement s'est déclenché, mais vous pouvez écouter les événements {{WebExtAPIRef("tabs.onUpdated")}} pour être averti lorsqu'une URL est définie.

+ +

Syntaxe

+ +
browser.tabs.onActivated.addListener(listener)
+browser.tabs.onActivated.removeListener(listener)
+browser.tabs.onActivated.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 :

+ +
+
activeInfo
+
object. ID de l'onglet qui a été activé, et ID de sa fenêtre.
+
+
+
+ +

Objets supplémentaires

+ +

activeInfo

+ +
+
previousTabId
+
integer. L'ID de l'onglet activé précédent, si cet onglet est encore ouvert.
+
tabId
+
integer. L'ID de l'onglet qui est devenu actif.
+
windowId
+
integer. L'ID de la fenêtre de l'onglet.
+
+ +

Exemples

+ +

Écouter et enregistrer les événements d'activation des onglets :

+ +
function handleActivated(activeInfo) {
+  console.log("Tab " + activeInfo.tabId +
+              " was activated");
+}
+
+browser.tabs.onActivated.addListener(handleActivated);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.html deleted file mode 100644 index 1e64ef3cfa..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: tabs.onActiveChanged -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onActiveChanged -tags: - - API - - Add-ons - - Deprecated - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onActiveChanged - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onActiveChanged ---- -
{{AddonSidebar()}}
- -
-

Attention : Cet événement est obsolète. Utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.

-
- -

Se déclenche lorsque l'onglet sélectionné dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement a été déclenché, mais vous pouvez écouter les événements {{WebExtAPIRef('tabs.onUpdated')}} pour être averti lorsqu'une URL est définie.

- -

Syntaxe

- -
browser.tabs.onActiveChanged.addListener(listener)
-browser.tabs.onActiveChanged.removeListener(listener)
-browser.tabs.onActiveChanged.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. Renvoietrue 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 :

- -
-
tabId
-
integer. L'ID de l'onglet qui est devenu actif.
-
- -
-
selectInfo
-
object.
-
-
-
- -

Objets supplémentaires

- -

selectInfo

- -
-
windowId
-
integer. L'ID de la fenêtre contenant l'onglet sélectionné.
-
- -

Compatibilité du navigateur

- -

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

- -

-

Note :

- -

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.

- -

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.

-
-

- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md new file mode 100644 index 0000000000..1e64ef3cfa --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onactivechanged/index.md @@ -0,0 +1,118 @@ +--- +title: tabs.onActiveChanged +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onActiveChanged +tags: + - API + - Add-ons + - Deprecated + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onActiveChanged + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onActiveChanged +--- +
{{AddonSidebar()}}
+ +
+

Attention : Cet événement est obsolète. Utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.

+
+ +

Se déclenche lorsque l'onglet sélectionné dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement a été déclenché, mais vous pouvez écouter les événements {{WebExtAPIRef('tabs.onUpdated')}} pour être averti lorsqu'une URL est définie.

+ +

Syntaxe

+ +
browser.tabs.onActiveChanged.addListener(listener)
+browser.tabs.onActiveChanged.removeListener(listener)
+browser.tabs.onActiveChanged.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. Renvoietrue 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 :

+ +
+
tabId
+
integer. L'ID de l'onglet qui est devenu actif.
+
+ +
+
selectInfo
+
object.
+
+
+
+ +

Objets supplémentaires

+ +

selectInfo

+ +
+
windowId
+
integer. L'ID de la fenêtre contenant l'onglet sélectionné.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

+

Note :

+ +

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.

+ +

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.

+
+

+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.html deleted file mode 100644 index 6e28fc017e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: tabs.onAttached -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onAttached -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onAttached - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onAttached ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'un onglet est attaché à une fenêtre, par exemple parce qu'il a été déplacé entre les fenêtres.

- -

Syntaxe

- -
browser.tabs.onAttached.addListener(listener)
-browser.tabs.onAttached.removeListener(listener)
-browser.tabs.onAttached.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)
-
CVé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 :

- -
-
tabId
-
integer. ID de l'onglet qui a été attaché à une nouvelle fenêtre..
-
- -
-
attachInfo
-
object. ID de la nouvelle fenêtre, et index de l'onglet à l'intérieur.
-
-
-
- -

Objets supplémentaires

- -

attachInfo

- -
-
newWindowId
-
integer. ID de la nouvelle fenêtre.
-
newPosition
-
integer. Position de l'index que l'onglet a dans la nouvelle fenêtre.
-
- -

Exemples

- -

Écoutez les événements attachés et consignez les informations :

- -
function handleAttached(tabId, attachInfo) {
-  console.log("Tab: " + tabId + " attached");
-  console.log("New window: " + attachInfo.newWindowId);
-  console.log("New index: " + attachInfo.newPosition);
-}
-
-browser.tabs.onAttached.addListener(handleAttached);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md new file mode 100644 index 0000000000..6e28fc017e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onattached/index.md @@ -0,0 +1,124 @@ +--- +title: tabs.onAttached +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onAttached +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onAttached + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onAttached +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'un onglet est attaché à une fenêtre, par exemple parce qu'il a été déplacé entre les fenêtres.

+ +

Syntaxe

+ +
browser.tabs.onAttached.addListener(listener)
+browser.tabs.onAttached.removeListener(listener)
+browser.tabs.onAttached.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)
+
CVé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 :

+ +
+
tabId
+
integer. ID de l'onglet qui a été attaché à une nouvelle fenêtre..
+
+ +
+
attachInfo
+
object. ID de la nouvelle fenêtre, et index de l'onglet à l'intérieur.
+
+
+
+ +

Objets supplémentaires

+ +

attachInfo

+ +
+
newWindowId
+
integer. ID de la nouvelle fenêtre.
+
newPosition
+
integer. Position de l'index que l'onglet a dans la nouvelle fenêtre.
+
+ +

Exemples

+ +

Écoutez les événements attachés et consignez les informations :

+ +
function handleAttached(tabId, attachInfo) {
+  console.log("Tab: " + tabId + " attached");
+  console.log("New window: " + attachInfo.newWindowId);
+  console.log("New index: " + attachInfo.newPosition);
+}
+
+browser.tabs.onAttached.addListener(handleAttached);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.html deleted file mode 100644 index 41488ce2c1..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: tabs.onCreated -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onCreated -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onCreated - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onCreated ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'un onglet est créé.

- -

Notez que l'URL de l'onglet peut ne pas avoir sa valeur finale au moment où cet événement a été déclenché. En particulier, Firefox ouvre un nouvel onglet avec l'URL  "about:blank" avant de charger la nouvelle page. Vous pouvez écouter les événements  {{WebExtAPIRef("tabs.onUpdated")}} pour être averti lorsqu'une URL est définie.

- -

Syntaxe

- -
browser.tabs.onCreated.addListener(callback)
-browser.tabs.onCreated.removeListener(listener)
-browser.tabs.onCreated.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 de listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifiez si le 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 :

- -
-
tab
-
{{WebExtAPIRef('tabs.Tab')}}. Détails de l'onglet qui a été créé.
-
-
-
- -

Examples

- -

Consignez les ID des nouveaux onglets créés :

- -
function handleCreated(tab) {
-  console.log(tab.id);
-}
-
-browser.tabs.onCreated.addListener(handleCreated);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md new file mode 100644 index 0000000000..41488ce2c1 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/oncreated/index.md @@ -0,0 +1,108 @@ +--- +title: tabs.onCreated +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onCreated +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onCreated + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onCreated +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'un onglet est créé.

+ +

Notez que l'URL de l'onglet peut ne pas avoir sa valeur finale au moment où cet événement a été déclenché. En particulier, Firefox ouvre un nouvel onglet avec l'URL  "about:blank" avant de charger la nouvelle page. Vous pouvez écouter les événements  {{WebExtAPIRef("tabs.onUpdated")}} pour être averti lorsqu'une URL est définie.

+ +

Syntaxe

+ +
browser.tabs.onCreated.addListener(callback)
+browser.tabs.onCreated.removeListener(listener)
+browser.tabs.onCreated.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 de listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifiez si le 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 :

+ +
+
tab
+
{{WebExtAPIRef('tabs.Tab')}}. Détails de l'onglet qui a été créé.
+
+
+
+ +

Examples

+ +

Consignez les ID des nouveaux onglets créés :

+ +
function handleCreated(tab) {
+  console.log(tab.id);
+}
+
+browser.tabs.onCreated.addListener(handleCreated);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.html deleted file mode 100644 index c6b5e83254..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: tabs.onDetached -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onDetached -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onDetached - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onDetached ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'un onglet est détaché d'une fenêtre, par exemple parce qu'il est déplacé entre des fenêtres.

- -

Syntaxe

- -
browser.tabs.onDetached.addListener(listener)
-browser.tabs.onDetached.removeListener(listener)
-browser.tabs.onDetached.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 de listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifiez si l'écouteur est enregistré pour cet événemen. 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 :

- -
-
tabId
-
integer. ID de l'onglet qui a été détaché.
-
- -
-
detachInfo
-
object. ID de la fenêtre précédente et index de l'onglet à l'intérieur.
-
-
-
- -

Objets supplémentaires

- -

detachInfo

- -
-
oldWindowId
-
integer. ID de la fenêtre précédente
-
oldPosition
-
integer. Position de l'index que l'onglet avait dans l'ancienne fenêtre.
-
- -

Exemples

- -

Ecoutez les événements de détachement et consignez les informations :

- -
function handleDetached(tabId, detachInfo) {
-  console.log("Tab: " + tabId + " moved");
-  console.log("Old window: " + detachInfo.oldWindowId);
-  console.log("Old index: " + detachInfo.oldPosition);
-}
-
-browser.tabs.onDetached.addListener(handleDetached);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md new file mode 100644 index 0000000000..c6b5e83254 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/ondetached/index.md @@ -0,0 +1,124 @@ +--- +title: tabs.onDetached +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onDetached +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onDetached + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onDetached +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'un onglet est détaché d'une fenêtre, par exemple parce qu'il est déplacé entre des fenêtres.

+ +

Syntaxe

+ +
browser.tabs.onDetached.addListener(listener)
+browser.tabs.onDetached.removeListener(listener)
+browser.tabs.onDetached.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 de listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifiez si l'écouteur est enregistré pour cet événemen. 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 :

+ +
+
tabId
+
integer. ID de l'onglet qui a été détaché.
+
+ +
+
detachInfo
+
object. ID de la fenêtre précédente et index de l'onglet à l'intérieur.
+
+
+
+ +

Objets supplémentaires

+ +

detachInfo

+ +
+
oldWindowId
+
integer. ID de la fenêtre précédente
+
oldPosition
+
integer. Position de l'index que l'onglet avait dans l'ancienne fenêtre.
+
+ +

Exemples

+ +

Ecoutez les événements de détachement et consignez les informations :

+ +
function handleDetached(tabId, detachInfo) {
+  console.log("Tab: " + tabId + " moved");
+  console.log("Old window: " + detachInfo.oldWindowId);
+  console.log("Old index: " + detachInfo.oldPosition);
+}
+
+browser.tabs.onDetached.addListener(handleDetached);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.html deleted file mode 100644 index 5ada516c51..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: tabs.onHighlightChanged -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlightChanged -tags: - - API - - Add-ons - - Deprecated - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onHighlightChanged - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlightChanged ---- -
{{AddonSidebar()}}
- -
-

Attention : Cet événement est obsolète. Utilisez {{WebExtAPIRef("tabs.onHighlighted")}} à la place.

- -

Lancé lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent.

- -

Syntaxe

- -
browser.tabs.onHighlightChanged.addListener(listener)
-browser.tabs.onHighlightChanged.removeListener(listener)
-browser.tabs.onHighlightChanged.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 trues'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 :

- -
-
selectInfo
-
object.
-
-
-
- -

Objets supplémentaires

- -

selectInfo

- -
-
windowId
-
integer. La fenêtre dont les onglets ont changé.
-
tabIds
-
array d'integer. Tous les onglets en surbrillance dans la fenêtre.
-
- -

Compatibilité du navigateur

- -

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

- -

-

Note :

- -

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.

- -

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.

-
-

- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md new file mode 100644 index 0000000000..5ada516c51 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlightchanged/index.md @@ -0,0 +1,111 @@ +--- +title: tabs.onHighlightChanged +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlightChanged +tags: + - API + - Add-ons + - Deprecated + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onHighlightChanged + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlightChanged +--- +
{{AddonSidebar()}}
+ +
+

Attention : Cet événement est obsolète. Utilisez {{WebExtAPIRef("tabs.onHighlighted")}} à la place.

+ +

Lancé lorsque les onglets en surbrillance ou sélectionnés dans une fenêtre changent.

+ +

Syntaxe

+ +
browser.tabs.onHighlightChanged.addListener(listener)
+browser.tabs.onHighlightChanged.removeListener(listener)
+browser.tabs.onHighlightChanged.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 trues'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 :

+ +
+
selectInfo
+
object.
+
+
+
+ +

Objets supplémentaires

+ +

selectInfo

+ +
+
windowId
+
integer. La fenêtre dont les onglets ont changé.
+
tabIds
+
array d'integer. Tous les onglets en surbrillance dans la fenêtre.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

+

Note :

+ +

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.

+ +

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.

+
+

+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.html deleted file mode 100644 index 58a21f1e5d..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.html +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: tabs.onHighlighted -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlighted -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onHighlighted - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlighted ---- -
{{AddonSidebar()}}
- -

Lancé lorsque l'ensemble des onglets en surbrillance dans une fenêtre change

- -

Notez qu'avant la version 63, Firefox n'avait pas le concept de mettre en évidence plusieurs onglets, donc cet événement n'était qu'un alias pour {{WebExtAPIRef("tabs.onActivated")}}.

- -

Syntaxe

- -
browser.tabs.onHighlighted.addListener(listener)
-browser.tabs.onHighlighted.removeListener(listener)
-browser.tabs.onHighlighted.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 de l'écouteur 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 :

- -
-
highlightInfo
-
object. ID(s) des onglets en surbrillance, et ID de leur fenêtre.
-
-
-
- -

Objets supplémentaires

- -

highlightInfo

- -
-
windowId
-
integer. ID de la fenêtre dont les onglets ont changé.
-
tabIds
-
array d'integer. Identifiants des onglets en surbrillance dans la fenêtre
-
- -

Exemples

- -

Ecoutez les événements en surbrillance et consignez les ID des onglets mis en surbrillance

- -
function handleHighlighted(highlightInfo) {
-  console.log("Highlighted tabs: " + highlightInfo.tabIds);
-}
-
-browser.tabs.onHighlighted.addListener(handleHighlighted);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md new file mode 100644 index 0000000000..58a21f1e5d --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onhighlighted/index.md @@ -0,0 +1,117 @@ +--- +title: tabs.onHighlighted +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlighted +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onHighlighted + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onHighlighted +--- +
{{AddonSidebar()}}
+ +

Lancé lorsque l'ensemble des onglets en surbrillance dans une fenêtre change

+ +

Notez qu'avant la version 63, Firefox n'avait pas le concept de mettre en évidence plusieurs onglets, donc cet événement n'était qu'un alias pour {{WebExtAPIRef("tabs.onActivated")}}.

+ +

Syntaxe

+ +
browser.tabs.onHighlighted.addListener(listener)
+browser.tabs.onHighlighted.removeListener(listener)
+browser.tabs.onHighlighted.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 de l'écouteur 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 :

+ +
+
highlightInfo
+
object. ID(s) des onglets en surbrillance, et ID de leur fenêtre.
+
+
+
+ +

Objets supplémentaires

+ +

highlightInfo

+ +
+
windowId
+
integer. ID de la fenêtre dont les onglets ont changé.
+
tabIds
+
array d'integer. Identifiants des onglets en surbrillance dans la fenêtre
+
+ +

Exemples

+ +

Ecoutez les événements en surbrillance et consignez les ID des onglets mis en surbrillance

+ +
function handleHighlighted(highlightInfo) {
+  console.log("Highlighted tabs: " + highlightInfo.tabIds);
+}
+
+browser.tabs.onHighlighted.addListener(handleHighlighted);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.html deleted file mode 100644 index a9ab08a87f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.html +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: tabs.onMoved -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onMoved -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onMoved - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onMoved ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'un onglet est déplacé dans une fenêtre

- -

Un seul événement de déplacement est déclenché, représentant l'onglet que l'utilisateur a déplacé directement. Les événements de déplacement ne sont pas déclenchés pour les autres onglets qui doivent se déplacer en réponse. Cet événement n'est pas déclenché lorsqu'un onglet est déplacé entre des fenêtres. Pour cela, voir  {{WebExtAPIRef('tabs.onDetached')}}.

- -

Syntaxe

- -
browser.tabs.onMoved.addListener(listener)
-browser.tabs.onMoved.removeListener(listener)
-browser.tabs.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 st l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifiez si le listenerest 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 :

- -
-
tabId
-
integer. ID de l'onglet déplacé par l'utilisateur.
-
- -
-
moveInfo
-
object. Informations sur le déménagement.
-
-
-
- -

Objets supplémentaires

- -

moveInfo

- -
-
windowId
-
integer. ID de la fenêtre de cet onglet.
-
fromIndex
-
integer. Index initial de cet onglet dans la fenêtre.
-
toIndex
-
integer. Index final de cet onglet dans la fenêtre
-
- -

Exemples

- -

Écouter et enregistrer les événements de déplacement :

- -
function handleMoved(tabId, moveInfo) {
-  console.log("Tab " + tabId +
-              " moved from " + moveInfo.fromIndex +
-              " to " + moveInfo.toIndex);
-}
-
-browser.tabs.onMoved.addListener(handleMoved);
- -

{{WebExtExamples}}

- -
-
- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md new file mode 100644 index 0000000000..a9ab08a87f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onmoved/index.md @@ -0,0 +1,131 @@ +--- +title: tabs.onMoved +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onMoved +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onMoved + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onMoved +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'un onglet est déplacé dans une fenêtre

+ +

Un seul événement de déplacement est déclenché, représentant l'onglet que l'utilisateur a déplacé directement. Les événements de déplacement ne sont pas déclenchés pour les autres onglets qui doivent se déplacer en réponse. Cet événement n'est pas déclenché lorsqu'un onglet est déplacé entre des fenêtres. Pour cela, voir  {{WebExtAPIRef('tabs.onDetached')}}.

+ +

Syntaxe

+ +
browser.tabs.onMoved.addListener(listener)
+browser.tabs.onMoved.removeListener(listener)
+browser.tabs.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 st l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifiez si le listenerest 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 :

+ +
+
tabId
+
integer. ID de l'onglet déplacé par l'utilisateur.
+
+ +
+
moveInfo
+
object. Informations sur le déménagement.
+
+
+
+ +

Objets supplémentaires

+ +

moveInfo

+ +
+
windowId
+
integer. ID de la fenêtre de cet onglet.
+
fromIndex
+
integer. Index initial de cet onglet dans la fenêtre.
+
toIndex
+
integer. Index final de cet onglet dans la fenêtre
+
+ +

Exemples

+ +

Écouter et enregistrer les événements de déplacement :

+ +
function handleMoved(tabId, moveInfo) {
+  console.log("Tab " + tabId +
+              " moved from " + moveInfo.fromIndex +
+              " to " + moveInfo.toIndex);
+}
+
+browser.tabs.onMoved.addListener(handleMoved);
+ +

{{WebExtExamples}}

+ +
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.html deleted file mode 100644 index 360e8ac589..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: tabs.onRemoved -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onRemoved -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onRemoved - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onRemoved ---- -
{{AddonSidebar()}}
- -

Lancé quand un onglet est fermé.

- -

Syntaxe

- -
browser.tabs.onRemoved.addListener(callback)
-browser.tabs.onRemoved.removeListener(listener)
-browser.tabs.onRemoved.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 :

- -
-
tabId
-
integer. ID de l'onglet qui s'est fermé.
-
- -
-
removeInfo
-
object. L'ID de la fenêtre de l'onglet et un booléen indiquant si la fenêtre est également fermée.
-
-
-
- -

Objets supplémentaires

- -

removeInfo

- -
-
windowId
-
integer. La fenêtre dont l'onglet est fermé.
-
isWindowClosing
-
boolean. true si l'onglet est fermé car sa fenêtre est en cours de fermeture.
-
- -

Exemples

- -

Écoutez les événements proches et consignez les informations :

- -
function handleRemoved(tabId, removeInfo) {
-  console.log("Tab: " + tabId + " is closing");
-  console.log("Window ID: " + removeInfo.windowId);
-  console.log("Window is closing: " + removeInfo.isWindowClosing);
-}
-
-browser.tabs.onRemoved.addListener(handleRemoved);
- -

{{WebExtExamples}}

- -
-
- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md new file mode 100644 index 0000000000..360e8ac589 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onremoved/index.md @@ -0,0 +1,127 @@ +--- +title: tabs.onRemoved +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onRemoved +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onRemoved + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onRemoved +--- +
{{AddonSidebar()}}
+ +

Lancé quand un onglet est fermé.

+ +

Syntaxe

+ +
browser.tabs.onRemoved.addListener(callback)
+browser.tabs.onRemoved.removeListener(listener)
+browser.tabs.onRemoved.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 :

+ +
+
tabId
+
integer. ID de l'onglet qui s'est fermé.
+
+ +
+
removeInfo
+
object. L'ID de la fenêtre de l'onglet et un booléen indiquant si la fenêtre est également fermée.
+
+
+
+ +

Objets supplémentaires

+ +

removeInfo

+ +
+
windowId
+
integer. La fenêtre dont l'onglet est fermé.
+
isWindowClosing
+
boolean. true si l'onglet est fermé car sa fenêtre est en cours de fermeture.
+
+ +

Exemples

+ +

Écoutez les événements proches et consignez les informations :

+ +
function handleRemoved(tabId, removeInfo) {
+  console.log("Tab: " + tabId + " is closing");
+  console.log("Window ID: " + removeInfo.windowId);
+  console.log("Window is closing: " + removeInfo.isWindowClosing);
+}
+
+browser.tabs.onRemoved.addListener(handleRemoved);
+ +

{{WebExtExamples}}

+ +
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.html deleted file mode 100644 index 346770d48e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.html +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: tabs.onReplaced -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onReplaced -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onReplaced - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onReplaced ---- -
{{AddonSidebar()}}
- -

Lancé lorsqu'un onglet est remplacé par un autre en raison d'un prérendering ou d'un instantané.

- -

Cet événement peut ne pas être pertinent ou pris en charge par des navigateurs autres que Chrome.

- -

Syntaxe

- -
browser.tabs.onReplaced.addListener(listener)
-browser.tabs.onReplaced.removeListener(listener)
-browser.tabs.onReplaced.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 :

- -
-
addedTabId
-
integer. ID de l'onglet de remplacement.
-
- -
-
removedTabId
-
integer. ID de l'onglet qui a été remplacé.
-
-
-
- -

Exemples

- -

Écoutez les événements de remplacement et consignez les informations associées :

- -
function handleReplaced(addedTabId, removedTabId) {
-  console.log("New tab: " + addedTabId);
-  console.log("Old tab: " + removedTabId);
-}
-
-browser.tabs.onReplaced.addListener(handleReplaced);
-
- -

{{WebExtExamples}}

- - - -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md new file mode 100644 index 0000000000..346770d48e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onreplaced/index.md @@ -0,0 +1,117 @@ +--- +title: tabs.onReplaced +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onReplaced +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onReplaced + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onReplaced +--- +
{{AddonSidebar()}}
+ +

Lancé lorsqu'un onglet est remplacé par un autre en raison d'un prérendering ou d'un instantané.

+ +

Cet événement peut ne pas être pertinent ou pris en charge par des navigateurs autres que Chrome.

+ +

Syntaxe

+ +
browser.tabs.onReplaced.addListener(listener)
+browser.tabs.onReplaced.removeListener(listener)
+browser.tabs.onReplaced.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 :

+ +
+
addedTabId
+
integer. ID de l'onglet de remplacement.
+
+ +
+
removedTabId
+
integer. ID de l'onglet qui a été remplacé.
+
+
+
+ +

Exemples

+ +

Écoutez les événements de remplacement et consignez les informations associées :

+ +
function handleReplaced(addedTabId, removedTabId) {
+  console.log("New tab: " + addedTabId);
+  console.log("Old tab: " + removedTabId);
+}
+
+browser.tabs.onReplaced.addListener(handleReplaced);
+
+ +

{{WebExtExamples}}

+ + + +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.html deleted file mode 100644 index 32841dc868..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.html +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: tabs.onSelectionChanged -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onSelectionChanged -tags: - - API - - Add-ons - - Deprecated - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onSelectionChanged - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onSelectionChanged ---- -
{{AddonSidebar()}}
- -
-

Attention : Cet événement est obsolète. Utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.

-
- -

Se déclenche lorsque l'onglet sélectionné dans une fenêtre change.

- -

Syntaxe

- -
browser.tabs.onSelectionChanged.addListener(listener)
-browser.tabs.onSelectionChanged.removeListener(listener)
-browser.tabs.onSelectionChanged.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 :

- -
-
tabId
-
integer. L'ID de l'onglet qui est devenu actif.
-
- -
-
selectInfo
-
object.
-
-
-
- -

Objets supplémentaires

- -

selectInfo

- -
-
windowId
-
integer. L'ID de la fenêtre dans laquelle l'onglet sélectionné a changé.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md new file mode 100644 index 0000000000..32841dc868 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onselectionchanged/index.md @@ -0,0 +1,115 @@ +--- +title: tabs.onSelectionChanged +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onSelectionChanged +tags: + - API + - Add-ons + - Deprecated + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onSelectionChanged + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onSelectionChanged +--- +
{{AddonSidebar()}}
+ +
+

Attention : Cet événement est obsolète. Utilisez {{WebExtAPIRef("tabs.onActivated")}} à la place.

+
+ +

Se déclenche lorsque l'onglet sélectionné dans une fenêtre change.

+ +

Syntaxe

+ +
browser.tabs.onSelectionChanged.addListener(listener)
+browser.tabs.onSelectionChanged.removeListener(listener)
+browser.tabs.onSelectionChanged.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 :

+ +
+
tabId
+
integer. L'ID de l'onglet qui est devenu actif.
+
+ +
+
selectInfo
+
object.
+
+
+
+ +

Objets supplémentaires

+ +

selectInfo

+ +
+
windowId
+
integer. L'ID de la fenêtre dans laquelle l'onglet sélectionné a changé.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.html deleted file mode 100644 index a434d27b61..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.html +++ /dev/null @@ -1,272 +0,0 @@ ---- -title: tabs.onUpdated -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onUpdated - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated ---- -

C'est déclenché lorsqu'un onglet est mis à jour.

- -

Lorsque l'utilisateur navigue vers une nouvelle URL dans un onglet, cela génère généralement plusieurs événements onUpdated au fur et à mesure que diverses propriétés de l'objet {{WebExtAPIRef("tabs.Tab")}} sont mises à jour. Ceci inclut l' url, mais aussi potentiellement le title et les propriétés favIconUrl. La propriété du  status passe par le "loading" et "complete".

- -

Cet événement sera également déclenché pour les modifications des propriétés d'un onglet qui n'impliquent pas de navigation, comme le pinning et le débrochage (qui met à jour la propriété pinned) et le muting ou le unmuting (qui met à jour les propriétés  audible et mutedInfo).

- -

Vous pouvez filtrer cet événement, en le rendant uniquement valable pour les onglets dont les urls correspondent à des patterns spécifiques, ou pour les modifications de propriétés spécifiques, ou pour les modifications d'un onglet ou d'une fenêtre spécifique, ou toute combinaison de ces restrictions.

- -

Syntaxe

- -
browser.tabs.onUpdated.addListener(listener[, extraParameters])
-browser.tabs.onUpdated.removeListener(listener)
-browser.tabs.onUpdated.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback[, extraParameters])
-
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 produira. La fonction sera passée les arguments suivants :

- -
-
tabId
-
integer. ID de l'onglet qui a été mis à jour.
-
changeInfo
-
object. ontient les propriétés des propriétés de l'onglet qui ont été modifiées. Voir changeInfo ci-dessous.
-
tab
-
{{WebExtAPIRef('tabs.Tab')}}. Le nouvel état de l'onglet.
-
-
-
extraParameters{{optional_inline}}
-
-

object. Un ensemble de filtres qui restreint les événements qui seront envoyés à cet auditeur. C'est un objet qui peut avoir une ou plusieurs des propriétés suivantes. Les événements ne seront envoyés que s'ils satisfont à tous les filtres donnés.

- -
-
urls
-
Array. Un tableau match patterns. Ne déclenchez l'événement que pour les onglets dont la propriété de l'url courante correspond à l'un des motifs.
-
properties
-
-

Array. un tableau de chaîne de caractères,  qui sont les noms des propriétés de l'objet {{WebExtAPIRef("tabs.Tab")}}. Ne déclenchez cet événement seulement pour les changement apportées à l'une des propriétés nommées dans ce tableau. Les propriétés suivantes peuvent être listées ici :

- -
    -
  • "attention"
    • -
  • "audible"
    • -
  • "discarded"
    • -
  • "favIconUrl"
    • -
  • "hidden"
    • -
  • "isArticle"
    • -
  • "mutedInfo"
    • -
  • "pinned"
    • -
  • "sharingState"
    • -
  • "status"
    • -
  • "title"
    • -
-
-
tabId
-
Integer. Ne déclenchez cet événement que pour l'onglet identifié par cet ID.
-
windowId
-
Integer. N'activez cet événement que pour les onglets qui se trouvent actuellement dans la fenêtre identifiée par cet ID.
-
-
-
- -

Objets supplémentaires

- -

changeInfo

- -

Répertorie les modifications apportées à l'état de l'onglet mis à jour. Pour en savoir plus sur ces propriétés, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.

- -
-
attention {{optional_inline}}
-
boolean. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, attention sera true.
-
audible{{optional_inline}}
-
boolean. Nouvel état audible de l'onglet.
-
discarded {{optional_inline}}
-
boolean. Si l'onglet est ignoré. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.
-
favIconUrl{{optional_inline}}
-
string. Nouvelle URL de favicon de l'onglet.
-
mutedInfo{{optional_inline}}
-
{{WebExtAPIRef('tabs.MutedInfo')}}. Le nouvel état muet de l'onglet et la raison du changement.
-
pinned{{optional_inline}}
-
boolean. Nouvel état épinglé de l'onglet.
-
status{{optional_inline}}
-
string. Le statut de l'onglet. Peut être soit chargé ou complet.
-
title{{optional_inline}}
-
string. Le nouveau titre de l'onglet.
-
url{{optional_inline}}
-
string. L'URL de l'onglet s'il a changé.
-
- -

Exemples

- -

Écoutez et connectez toutes les informations de changement et nouvel état:

- -
function handleUpdated(tabId, changeInfo, tabInfo) {
-  console.log("Updated tab: " + tabId);
-  console.log("Changed attributes: ");
-  console.log(changeInfo);
-  console.log("New tab Info: ");
-  console.log(tabInfo);
-}
-
-browser.tabs.onUpdated.addListener(handleUpdated);
- -

Consigner les modifications dans les URL :

- -
function handleUpdated(tabId, changeInfo, tabInfo) {
-  if (changeInfo.url) {
-    console.log("Tab: " + tabId +
-                " URL changed to " + changeInfo.url);
-  }
-}
-
-browser.tabs.onUpdated.addListener(handleUpdated);
- -

Filtering examples

- -

Le journal ne change que pour les onglets dont la propriété url est matched par "https://developer.mozilla.org/*" ou "https://twitter.com/mozdevnet":

- -
const pattern1 = "https://developer.mozilla.org/*";
-const pattern2 = "https://twitter.com/mozdevnet";
-
-const filter = {
-  urls: [pattern1, pattern2]
-}
-
-function handleUpdated(tabId, changeInfo, tabInfo) {
-  console.log(`Updated tab: ${tabId}`);
-  console.log("Changed attributes: ", changeInfo);
-  console.log("New tab Info: ", tabInfo);
-}
-
-browser.tabs.onUpdated.addListener(handleUpdated, filter);
- -

Le journal ne change que la propriété épinglée des onglets (c'est-à-dire les actions d'épinglage et de déblocage) :

- -
const filter = {
-  properties: ["pinned"]
-}
-
-function handleUpdated(tabId, changeInfo, tabInfo) {
-  console.log(`Updated tab: ${tabId}`);
-  console.log("Changed attributes: ", changeInfo);
-  console.log("New tab Info: ", tabInfo);
-}
-
-browser.tabs.onUpdated.addListener(handleUpdated, filter);
- -

Combiner les deux filtres précédents : changements de journal seulement :

- - - -
const pattern1 = "https://developer.mozilla.org/*";
-const pattern2 = "https://twitter.com/mozdevnet";
-
-const filter = {
-  urls: [pattern1, pattern2],
-  properties: ["pinned"]
-}
-
-function handleUpdated(tabId, changeInfo, tabInfo) {
-  console.log(`Updated tab: ${tabId}`);
-  console.log("Changed attributes: ", changeInfo);
-  console.log("New tab Info: ", tabInfo);
-}
-
-browser.tabs.onUpdated.addListener(
-  handleUpdated,
-  filter);
- -

Changements dans le journal seulement :

- - - -
const pattern1 = "https://developer.mozilla.org/*";
-const pattern2 = "https://twitter.com/mozdevnet";
-
-const filter = {
-  urls: [pattern1, pattern2],
-  properties: ["pinned"],
-  windowId: browser.windows.WINDOW_ID_CURRENT
-}
-
-function handleUpdated(tabId, changeInfo, tabInfo) {
-  console.log(`Updated tab: ${tabId}`);
-  console.log("Changed attributes: ", changeInfo);
-  console.log("New tab Info: ", tabInfo);
-}
-
-browser.tabs.onUpdated.addListener(
-  handleUpdated,
-  filter);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.onUpdated", 10)}}

- -

Note :

- -

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.

-
- - - -

{{AddonSidebar}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md new file mode 100644 index 0000000000..a434d27b61 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onupdated/index.md @@ -0,0 +1,272 @@ +--- +title: tabs.onUpdated +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onUpdated + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onUpdated +--- +

C'est déclenché lorsqu'un onglet est mis à jour.

+ +

Lorsque l'utilisateur navigue vers une nouvelle URL dans un onglet, cela génère généralement plusieurs événements onUpdated au fur et à mesure que diverses propriétés de l'objet {{WebExtAPIRef("tabs.Tab")}} sont mises à jour. Ceci inclut l' url, mais aussi potentiellement le title et les propriétés favIconUrl. La propriété du  status passe par le "loading" et "complete".

+ +

Cet événement sera également déclenché pour les modifications des propriétés d'un onglet qui n'impliquent pas de navigation, comme le pinning et le débrochage (qui met à jour la propriété pinned) et le muting ou le unmuting (qui met à jour les propriétés  audible et mutedInfo).

+ +

Vous pouvez filtrer cet événement, en le rendant uniquement valable pour les onglets dont les urls correspondent à des patterns spécifiques, ou pour les modifications de propriétés spécifiques, ou pour les modifications d'un onglet ou d'une fenêtre spécifique, ou toute combinaison de ces restrictions.

+ +

Syntaxe

+ +
browser.tabs.onUpdated.addListener(listener[, extraParameters])
+browser.tabs.onUpdated.removeListener(listener)
+browser.tabs.onUpdated.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback[, extraParameters])
+
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 produira. La fonction sera passée les arguments suivants :

+ +
+
tabId
+
integer. ID de l'onglet qui a été mis à jour.
+
changeInfo
+
object. ontient les propriétés des propriétés de l'onglet qui ont été modifiées. Voir changeInfo ci-dessous.
+
tab
+
{{WebExtAPIRef('tabs.Tab')}}. Le nouvel état de l'onglet.
+
+
+
extraParameters{{optional_inline}}
+
+

object. Un ensemble de filtres qui restreint les événements qui seront envoyés à cet auditeur. C'est un objet qui peut avoir une ou plusieurs des propriétés suivantes. Les événements ne seront envoyés que s'ils satisfont à tous les filtres donnés.

+ +
+
urls
+
Array. Un tableau match patterns. Ne déclenchez l'événement que pour les onglets dont la propriété de l'url courante correspond à l'un des motifs.
+
properties
+
+

Array. un tableau de chaîne de caractères,  qui sont les noms des propriétés de l'objet {{WebExtAPIRef("tabs.Tab")}}. Ne déclenchez cet événement seulement pour les changement apportées à l'une des propriétés nommées dans ce tableau. Les propriétés suivantes peuvent être listées ici :

+ +
    +
  • "attention"
    • +
  • "audible"
    • +
  • "discarded"
    • +
  • "favIconUrl"
    • +
  • "hidden"
    • +
  • "isArticle"
    • +
  • "mutedInfo"
    • +
  • "pinned"
    • +
  • "sharingState"
    • +
  • "status"
    • +
  • "title"
    • +
+
+
tabId
+
Integer. Ne déclenchez cet événement que pour l'onglet identifié par cet ID.
+
windowId
+
Integer. N'activez cet événement que pour les onglets qui se trouvent actuellement dans la fenêtre identifiée par cet ID.
+
+
+
+ +

Objets supplémentaires

+ +

changeInfo

+ +

Répertorie les modifications apportées à l'état de l'onglet mis à jour. Pour en savoir plus sur ces propriétés, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.

+ +
+
attention {{optional_inline}}
+
boolean. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, attention sera true.
+
audible{{optional_inline}}
+
boolean. Nouvel état audible de l'onglet.
+
discarded {{optional_inline}}
+
boolean. Si l'onglet est ignoré. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.
+
favIconUrl{{optional_inline}}
+
string. Nouvelle URL de favicon de l'onglet.
+
mutedInfo{{optional_inline}}
+
{{WebExtAPIRef('tabs.MutedInfo')}}. Le nouvel état muet de l'onglet et la raison du changement.
+
pinned{{optional_inline}}
+
boolean. Nouvel état épinglé de l'onglet.
+
status{{optional_inline}}
+
string. Le statut de l'onglet. Peut être soit chargé ou complet.
+
title{{optional_inline}}
+
string. Le nouveau titre de l'onglet.
+
url{{optional_inline}}
+
string. L'URL de l'onglet s'il a changé.
+
+ +

Exemples

+ +

Écoutez et connectez toutes les informations de changement et nouvel état:

+ +
function handleUpdated(tabId, changeInfo, tabInfo) {
+  console.log("Updated tab: " + tabId);
+  console.log("Changed attributes: ");
+  console.log(changeInfo);
+  console.log("New tab Info: ");
+  console.log(tabInfo);
+}
+
+browser.tabs.onUpdated.addListener(handleUpdated);
+ +

Consigner les modifications dans les URL :

+ +
function handleUpdated(tabId, changeInfo, tabInfo) {
+  if (changeInfo.url) {
+    console.log("Tab: " + tabId +
+                " URL changed to " + changeInfo.url);
+  }
+}
+
+browser.tabs.onUpdated.addListener(handleUpdated);
+ +

Filtering examples

+ +

Le journal ne change que pour les onglets dont la propriété url est matched par "https://developer.mozilla.org/*" ou "https://twitter.com/mozdevnet":

+ +
const pattern1 = "https://developer.mozilla.org/*";
+const pattern2 = "https://twitter.com/mozdevnet";
+
+const filter = {
+  urls: [pattern1, pattern2]
+}
+
+function handleUpdated(tabId, changeInfo, tabInfo) {
+  console.log(`Updated tab: ${tabId}`);
+  console.log("Changed attributes: ", changeInfo);
+  console.log("New tab Info: ", tabInfo);
+}
+
+browser.tabs.onUpdated.addListener(handleUpdated, filter);
+ +

Le journal ne change que la propriété épinglée des onglets (c'est-à-dire les actions d'épinglage et de déblocage) :

+ +
const filter = {
+  properties: ["pinned"]
+}
+
+function handleUpdated(tabId, changeInfo, tabInfo) {
+  console.log(`Updated tab: ${tabId}`);
+  console.log("Changed attributes: ", changeInfo);
+  console.log("New tab Info: ", tabInfo);
+}
+
+browser.tabs.onUpdated.addListener(handleUpdated, filter);
+ +

Combiner les deux filtres précédents : changements de journal seulement :

+ + + +
const pattern1 = "https://developer.mozilla.org/*";
+const pattern2 = "https://twitter.com/mozdevnet";
+
+const filter = {
+  urls: [pattern1, pattern2],
+  properties: ["pinned"]
+}
+
+function handleUpdated(tabId, changeInfo, tabInfo) {
+  console.log(`Updated tab: ${tabId}`);
+  console.log("Changed attributes: ", changeInfo);
+  console.log("New tab Info: ", tabInfo);
+}
+
+browser.tabs.onUpdated.addListener(
+  handleUpdated,
+  filter);
+ +

Changements dans le journal seulement :

+ + + +
const pattern1 = "https://developer.mozilla.org/*";
+const pattern2 = "https://twitter.com/mozdevnet";
+
+const filter = {
+  urls: [pattern1, pattern2],
+  properties: ["pinned"],
+  windowId: browser.windows.WINDOW_ID_CURRENT
+}
+
+function handleUpdated(tabId, changeInfo, tabInfo) {
+  console.log(`Updated tab: ${tabId}`);
+  console.log("Changed attributes: ", changeInfo);
+  console.log("New tab Info: ", tabInfo);
+}
+
+browser.tabs.onUpdated.addListener(
+  handleUpdated,
+  filter);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.onUpdated", 10)}}

+ +

Note :

+ +

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.

+
+ + + +

{{AddonSidebar}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.html deleted file mode 100644 index 67b0c63bd5..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: tabs.onZoomChange -slug: Mozilla/Add-ons/WebExtensions/API/tabs/onZoomChange -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - onZoomChange - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onZoomChange ---- -
{{AddonSidebar()}}
- -

Envoyé lorsqu'un onglet est agrandi.

- -

Syntaxe

- -
browser.tabs.onZoomChange.addListener(listener)
-browser.tabs.onZoomChange.removeListener(listener)
-browser.tabs.onZoomChange.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 de l'écouteur 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 :

- -
-
ZoomChangeInfo
-
object. Informations sur l'événement de zoom.
-
-
-
- -

Objets supplémentaires

- -

ZoomChangeInfo

- -
-
tabId
-
integer. ID de l'onglet qui a été zoomé.
-
oldZoomFactor
-
number. Le facteur de zoom précédent.
-
newZoomFactor
-
number. Le nouveau facteur de zoom.
-
zoomSettings
-
{{WebExtAPIRef('tabs.ZoomSettings')}}. Paramètres de zoom pour l'onglet.
-
- -

Exemples

- -

Ecoutez les événements de zoom et consignez les informations :

- -
function handleZoomed(zoomChangeInfo) {
-  console.log("Tab: " + zoomChangeInfo.tabId + " zoomed");
-  console.log("Old zoom: " + zoomChangeInfo.oldZoomFactor);
-  console.log("New zoom: " + zoomChangeInfo.newZoomFactor);
-}
-
-browser.tabs.onZoomChange.addListener(handleZoomed);
- -

{{WebExtExamples}}

- -
-
- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md new file mode 100644 index 0000000000..67b0c63bd5 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/onzoomchange/index.md @@ -0,0 +1,126 @@ +--- +title: tabs.onZoomChange +slug: Mozilla/Add-ons/WebExtensions/API/tabs/onZoomChange +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - onZoomChange + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/onZoomChange +--- +
{{AddonSidebar()}}
+ +

Envoyé lorsqu'un onglet est agrandi.

+ +

Syntaxe

+ +
browser.tabs.onZoomChange.addListener(listener)
+browser.tabs.onZoomChange.removeListener(listener)
+browser.tabs.onZoomChange.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 de l'écouteur 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 :

+ +
+
ZoomChangeInfo
+
object. Informations sur l'événement de zoom.
+
+
+
+ +

Objets supplémentaires

+ +

ZoomChangeInfo

+ +
+
tabId
+
integer. ID de l'onglet qui a été zoomé.
+
oldZoomFactor
+
number. Le facteur de zoom précédent.
+
newZoomFactor
+
number. Le nouveau facteur de zoom.
+
zoomSettings
+
{{WebExtAPIRef('tabs.ZoomSettings')}}. Paramètres de zoom pour l'onglet.
+
+ +

Exemples

+ +

Ecoutez les événements de zoom et consignez les informations :

+ +
function handleZoomed(zoomChangeInfo) {
+  console.log("Tab: " + zoomChangeInfo.tabId + " zoomed");
+  console.log("Old zoom: " + zoomChangeInfo.oldZoomFactor);
+  console.log("New zoom: " + zoomChangeInfo.newZoomFactor);
+}
+
+browser.tabs.onZoomChange.addListener(handleZoomed);
+ +

{{WebExtExamples}}

+ +
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.html deleted file mode 100644 index aae4f3a3e7..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: tabs.PageSettings -slug: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings -tags: - - API - - Add-ons - - Extensions - - PageSettings - - Reference - - Type - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings ---- -
{{AddonSidebar}}
- -

Le type tabs.PageSettings est utilisé pour contrôler le rendu d'un onglet au format PDF par la méthode  {{WebExtAPIRef("tabs.saveAsPDF()")}}.

- -

Toutes ses propriétés sont facultatives.

- -

Pour définir les en-têtes et les pieds de page, vous pouvez inclure certains caractères spéciaux dans les chaînes que vous fournissez. Ceux-ci seront remplacés dans la sortie rendue comme suit :

- - - -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
edgeBottom {{optional_inline}}
-
number. L'espacement entre le bas des pieds et le bord inférieur du papier (pouces). Par défaut : 0.
-
edgeLeft {{optional_inline}}
-
number. L'espacement entre l'en-tête / pied de page gauche et le bord gauche du papier (pouces). Par défaut : 0
-
edgeRight {{optional_inline}}
-
number. L'espacement entre l'en-tête / pied droit et le bord gauche du papier (pouces). Par défaut : 0.
-
edgeTop {{optional_inline}}
-
number. L'espacement entre le haut des en-têtes et le bord supérieur du papier (pouces). Par défaut : 0
-
footerCenter {{optional_inline}}
-
string. Le texte du pied de page central de la page. Défaut : ''.
-
footerLeft {{optional_inline}}
-
string. Le texte pour le pied gauche de la page. Par défaut :  '&PT'.
-
footerRight {{optional_inline}}
-
string. Le texte pour le pied droit de la page. Par défaut : '&D'.
-
headerCenter {{optional_inline}}
-
string. Le texte de l'en-tête du centre de la page. Défaut : ''.
-
headerLeft {{optional_inline}}
-
string. Le texte de l'en-tête gauche de la page. Par défaut : '&T'.
-
headerRight {{optional_inline}}
-
string. Le texte de l'en-tête de la page. Par défaut : '&U'.
-
marginBottom {{optional_inline}}
-
number. La marge entre le contenu de la page et le bord inférieur du papier (pouces). Par défaut : 0.5.
-
marginLeft {{optional_inline}}
-
number. La marge entre le contenu de la page et le bord gauche du papier (pouces). Par défaut : 0.5.
-
marginRight {{optional_inline}}
-
number. La marge entre le contenu de la page et le bord droit du papier (en pouces). Par défaut : 0.5.
-
marginTop {{optional_inline}}
-
number. La marge entre le contenu de la page et le bord supérieur du papier (pouces). Par défaut : 0.5.
-
orientation {{optional_inline}}
-
integer. Orientation de la page: 0 signifie "portrait", 1 signifie "paysage". Par défaut : 0.
-
paperHeight {{optional_inline}}
-
number. La hauteur du papier dans les unités de format papier. Par défaut : 11.0.
-
paperSizeUnit {{optional_inline}}
-
integer. L'unité de format de papier: 0 = pouces, 1 = millimètres. Par défaut : 0.
-
paperWidth {{optional_inline}}
-
number. La largeur du papier dans les unités de format papier. Par défaut : 8.5.
-
scaling {{optional_inline}}
-
number. Facteur d'échelle du contenu de la page. 1 signifie 100% ou taille normale. Par défaut : 1.
-
showBackgroundColors {{optional_inline}}
-
boolean. Si les couleurs d'arrière-plan de la page doivent être affichées. Par défaut : false.
-
showBackgroundImages {{optional_inline}}
-
boolean. Si les images d'arrière-plan de la page doivent être affichées. Par défaut : false.
-
shrinkToFit {{optional_inline}}
-
boolean. Si le contenu de la page doit rétrécir pour s'adapter à la largeur de la page (remplace la mise à l'échelle). Par défaut : true.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md new file mode 100644 index 0000000000..aae4f3a3e7 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/pagesettings/index.md @@ -0,0 +1,86 @@ +--- +title: tabs.PageSettings +slug: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings +tags: + - API + - Add-ons + - Extensions + - PageSettings + - Reference + - Type + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings +--- +
{{AddonSidebar}}
+ +

Le type tabs.PageSettings est utilisé pour contrôler le rendu d'un onglet au format PDF par la méthode  {{WebExtAPIRef("tabs.saveAsPDF()")}}.

+ +

Toutes ses propriétés sont facultatives.

+ +

Pour définir les en-têtes et les pieds de page, vous pouvez inclure certains caractères spéciaux dans les chaînes que vous fournissez. Ceux-ci seront remplacés dans la sortie rendue comme suit :

+ + + +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
edgeBottom {{optional_inline}}
+
number. L'espacement entre le bas des pieds et le bord inférieur du papier (pouces). Par défaut : 0.
+
edgeLeft {{optional_inline}}
+
number. L'espacement entre l'en-tête / pied de page gauche et le bord gauche du papier (pouces). Par défaut : 0
+
edgeRight {{optional_inline}}
+
number. L'espacement entre l'en-tête / pied droit et le bord gauche du papier (pouces). Par défaut : 0.
+
edgeTop {{optional_inline}}
+
number. L'espacement entre le haut des en-têtes et le bord supérieur du papier (pouces). Par défaut : 0
+
footerCenter {{optional_inline}}
+
string. Le texte du pied de page central de la page. Défaut : ''.
+
footerLeft {{optional_inline}}
+
string. Le texte pour le pied gauche de la page. Par défaut :  '&PT'.
+
footerRight {{optional_inline}}
+
string. Le texte pour le pied droit de la page. Par défaut : '&D'.
+
headerCenter {{optional_inline}}
+
string. Le texte de l'en-tête du centre de la page. Défaut : ''.
+
headerLeft {{optional_inline}}
+
string. Le texte de l'en-tête gauche de la page. Par défaut : '&T'.
+
headerRight {{optional_inline}}
+
string. Le texte de l'en-tête de la page. Par défaut : '&U'.
+
marginBottom {{optional_inline}}
+
number. La marge entre le contenu de la page et le bord inférieur du papier (pouces). Par défaut : 0.5.
+
marginLeft {{optional_inline}}
+
number. La marge entre le contenu de la page et le bord gauche du papier (pouces). Par défaut : 0.5.
+
marginRight {{optional_inline}}
+
number. La marge entre le contenu de la page et le bord droit du papier (en pouces). Par défaut : 0.5.
+
marginTop {{optional_inline}}
+
number. La marge entre le contenu de la page et le bord supérieur du papier (pouces). Par défaut : 0.5.
+
orientation {{optional_inline}}
+
integer. Orientation de la page: 0 signifie "portrait", 1 signifie "paysage". Par défaut : 0.
+
paperHeight {{optional_inline}}
+
number. La hauteur du papier dans les unités de format papier. Par défaut : 11.0.
+
paperSizeUnit {{optional_inline}}
+
integer. L'unité de format de papier: 0 = pouces, 1 = millimètres. Par défaut : 0.
+
paperWidth {{optional_inline}}
+
number. La largeur du papier dans les unités de format papier. Par défaut : 8.5.
+
scaling {{optional_inline}}
+
number. Facteur d'échelle du contenu de la page. 1 signifie 100% ou taille normale. Par défaut : 1.
+
showBackgroundColors {{optional_inline}}
+
boolean. Si les couleurs d'arrière-plan de la page doivent être affichées. Par défaut : false.
+
showBackgroundImages {{optional_inline}}
+
boolean. Si les images d'arrière-plan de la page doivent être affichées. Par défaut : false.
+
shrinkToFit {{optional_inline}}
+
boolean. Si le contenu de la page doit rétrécir pour s'adapter à la largeur de la page (remplace la mise à l'échelle). Par défaut : true.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.html deleted file mode 100644 index c2ab587834..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: tabs.print() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/print -tags: - - API - - Add-ons - - Extensions - - Méthode - - Reference - - WebExtensions - - impression - - print - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/print ---- -
{{AddonSidebar()}}
- -

Appelez cette fonction pour imprimer le contenu de l'onglet actif. Si cette fonction est appelée, l'utilisateur recevra la boîte de dialogue d'impression de la plate-forme sous-jacente et aura la possibilité de modifier les paramètres d'impression, puis d'imprimer l'onglet actuellement actif.

- -

Syntaxe

- -
browser.tabs.print()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

None.

- -

Exemples

- -

Dans cet exemple, un script d'arrière-plan écoute un clic sur une action navigateur, puis tente d'imprimer l'onglet actuellement actif :

- -
browser.browserAction.onClicked.addListener(() => {
-  browser.tabs.print();
-});
-
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md new file mode 100644 index 0000000000..c2ab587834 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/print/index.md @@ -0,0 +1,46 @@ +--- +title: tabs.print() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/print +tags: + - API + - Add-ons + - Extensions + - Méthode + - Reference + - WebExtensions + - impression + - print + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/print +--- +
{{AddonSidebar()}}
+ +

Appelez cette fonction pour imprimer le contenu de l'onglet actif. Si cette fonction est appelée, l'utilisateur recevra la boîte de dialogue d'impression de la plate-forme sous-jacente et aura la possibilité de modifier les paramètres d'impression, puis d'imprimer l'onglet actuellement actif.

+ +

Syntaxe

+ +
browser.tabs.print()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

None.

+ +

Exemples

+ +

Dans cet exemple, un script d'arrière-plan écoute un clic sur une action navigateur, puis tente d'imprimer l'onglet actuellement actif :

+ +
browser.browserAction.onClicked.addListener(() => {
+  browser.tabs.print();
+});
+
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.html deleted file mode 100644 index 277bc5af28..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: tabs.printPreview() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/printPreview -tags: - - API - - Add-ons - - Extensions - - Méthode - - Reference - - WebExtensions - - printPreview - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/printPreview ---- -
{{AddonSidebar()}}
- -
Ouvre l'aperçu avant impression pour l'onglet actif.
- -
- -
C'est une fonction asynchrone qui renvoie une Promise.
- -
- -
Une extension peut détecter lorsque l'aperçu d'impression a été fermé en écoutant l'événement afterprint :
- -
- -
-
window.addEventListener("afterprint", resumeFunction, false);
-
- -

Syntaxe

- -
var openingPreview = browser.tabs.printPreview()
-
- -

Paramètres

- -

None.

- -

Valeur retournée

- -

Une Promise qui sera remplie sans argument lorsque la page d'aperçu est ouverte.

- -

Exemples

- -

Dans cet exemple, un script d'arrière-plan écoute un clic sur une action de navigateur, puis ouvre l'aperçu avant impression pour l'onglet actuellement actif :

- -
browser.browserAction.onClicked.addListener(() => {
-  browser.tabs.printPreview()
-    .then(() => {
-      console.log("Entered print preview");
-    });
-});
-
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md new file mode 100644 index 0000000000..277bc5af28 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/printpreview/index.md @@ -0,0 +1,62 @@ +--- +title: tabs.printPreview() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/printPreview +tags: + - API + - Add-ons + - Extensions + - Méthode + - Reference + - WebExtensions + - printPreview + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/printPreview +--- +
{{AddonSidebar()}}
+ +
Ouvre l'aperçu avant impression pour l'onglet actif.
+ +
+ +
C'est une fonction asynchrone qui renvoie une Promise.
+ +
+ +
Une extension peut détecter lorsque l'aperçu d'impression a été fermé en écoutant l'événement afterprint :
+ +
+ +
+
window.addEventListener("afterprint", resumeFunction, false);
+
+ +

Syntaxe

+ +
var openingPreview = browser.tabs.printPreview()
+
+ +

Paramètres

+ +

None.

+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans argument lorsque la page d'aperçu est ouverte.

+ +

Exemples

+ +

Dans cet exemple, un script d'arrière-plan écoute un clic sur une action de navigateur, puis ouvre l'aperçu avant impression pour l'onglet actuellement actif :

+ +
browser.browserAction.onClicked.addListener(() => {
+  browser.tabs.printPreview()
+    .then(() => {
+      console.log("Entered print preview");
+    });
+});
+
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.html deleted file mode 100644 index 7e7a756610..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.html +++ /dev/null @@ -1,187 +0,0 @@ ---- -title: tabs.query() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/query -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - query - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/query ---- -
{{AddonSidebar()}}
- -

Obtient tous les onglets qui ont les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var querying = browser.tabs.query(
-  queryInfo             // object
-)
-
- -

Paramètres

- -
-
queryInfo
-

object. La fonction query() obtiendra uniquement les onglets dont les propriétés correspondent aux propriétés incluses ici. Pour en savoir plus sur ces propriétés, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.

-
-
active{{optional_inline}}
-
boolean. Si les onglets sont actifs dans leurs fenêtres.
-
audible{{optional_inline}}
-
boolean. Si les onglets sont audibles.
-
autoDiscardable{{optional_inline}}
-
boolean. Si les onglets peuvent être supprimés automatiquement par le navigateur lorsque les ressources sont faibles.
-
cookieStoreId {{optional_inline}}
-
string. Utilisez cette option pour renvoyer uniquement les onglets dont l'ID est cookieStoreId. Cette option n'est disponible que si l'extension à la  permission "cookies"
-
currentWindow{{optional_inline}}
-
boolean. Si les onglets sont dans la fenêtre actuelle.
-
discarded{{optional_inline}}
-
boolean. Si les onglets sont supprimés. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.***
-
hidden{{optional_inline}}
-
boolean. Si les onglets sont cachés.
-
highlighted{{optional_inline}}
-
boolean. Si les onglets sont en surbrillance.
-
index{{optional_inline}}
-
integer. La position des onglets dans leurs fenêtres.
-
muted{{optional_inline}}
-
boolean. Si les onglets sont en sourdine.
-
lastFocusedWindow{{optional_inline}}
-
boolean. Si les onglets sont dans la dernière fenêtre focalisée.
-
openerTabId{{optional_inline}}
-
integer. L'ID de l'onglet qui a ouvert cet onglet.
-
pinned{{optional_inline}}
-
boolean. Si les onglets sont épinglés.
-
status{{optional_inline}}
-
{{WebExtAPIRef('tabs.TabStatus')}}. Si les onglets ont terminé le chargement.
-
title{{optional_inline}}
-
string. Faites correspondre les titres de page à un motif.
-
url{{optional_inline}}
-
string ou array de string. Faites correspondre les onglets avec un ou plusieurs modèle de correspondance. Notez que les identificateurs de fragment ne sont pas appariés.
-
windowId{{optional_inline}}
-
integer. L'ID de la fenêtre parente, ou  {{WebExtAPIRef('windows.WINDOW_ID_CURRENT')}} pour la fenêtre en cours.
-
windowType{{optional_inline}}
-
{{WebExtAPIRef('tabs.WindowType')}}. Le type de fenêtre dans lequel les onglets y  sont.
-
-
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec un tableau d'objets {{WebExtAPIRef('tabs.Tab')}}, contenant des informations sur chaque onglet correspondant. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Obtenez tous les onglets :

- -
function logTabs(tabs) {
-  for (let tab of tabs) {
-    // tab.url requires the `tabs` permission
-    console.log(tab.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var querying = browser.tabs.query({});
-querying.then(logTabs, onError);
- -

Obtenez tous les onglets dans la fenêtre actuelle :

- -
function logTabs(tabs) {
-  for (let tab of tabs) {
-    // tab.url requires the `tabs` permission
-    console.log(tab.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var querying = browser.tabs.query({currentWindow: true});
-querying.then(logTabs, onError);
- -

Obtenez l'onglet actif dans la fenêtre actuelle :

- -
function logTabs(tabs) {
-  for (let tab of tabs) {
-    // tab.url requires the `tabs` permission
-    console.log(tab.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var querying = browser.tabs.query({currentWindow: true, active: true});
-querying.then(logTabs, onError);
- -

Obtenez des onglets pour toutes les URL HTTP et HTTPS sous "mozilla.org" ou l'un de ses sous-domaines :

- -
function logTabs(tabs) {
-  for (let tab of tabs) {
-    // tab.url requires the `tabs` permission
-    console.log(tab.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var querying = browser.tabs.query({url: "*://*.mozilla.org/*"});
-querying.then(logTabs, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md new file mode 100644 index 0000000000..7e7a756610 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/query/index.md @@ -0,0 +1,187 @@ +--- +title: tabs.query() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/query +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - query + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/query +--- +
{{AddonSidebar()}}
+ +

Obtient tous les onglets qui ont les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var querying = browser.tabs.query(
+  queryInfo             // object
+)
+
+ +

Paramètres

+ +
+
queryInfo
+

object. La fonction query() obtiendra uniquement les onglets dont les propriétés correspondent aux propriétés incluses ici. Pour en savoir plus sur ces propriétés, consultez la documentation {{WebExtAPIRef("tabs.Tab")}}.

+
+
active{{optional_inline}}
+
boolean. Si les onglets sont actifs dans leurs fenêtres.
+
audible{{optional_inline}}
+
boolean. Si les onglets sont audibles.
+
autoDiscardable{{optional_inline}}
+
boolean. Si les onglets peuvent être supprimés automatiquement par le navigateur lorsque les ressources sont faibles.
+
cookieStoreId {{optional_inline}}
+
string. Utilisez cette option pour renvoyer uniquement les onglets dont l'ID est cookieStoreId. Cette option n'est disponible que si l'extension à la  permission "cookies"
+
currentWindow{{optional_inline}}
+
boolean. Si les onglets sont dans la fenêtre actuelle.
+
discarded{{optional_inline}}
+
boolean. Si les onglets sont supprimés. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.***
+
hidden{{optional_inline}}
+
boolean. Si les onglets sont cachés.
+
highlighted{{optional_inline}}
+
boolean. Si les onglets sont en surbrillance.
+
index{{optional_inline}}
+
integer. La position des onglets dans leurs fenêtres.
+
muted{{optional_inline}}
+
boolean. Si les onglets sont en sourdine.
+
lastFocusedWindow{{optional_inline}}
+
boolean. Si les onglets sont dans la dernière fenêtre focalisée.
+
openerTabId{{optional_inline}}
+
integer. L'ID de l'onglet qui a ouvert cet onglet.
+
pinned{{optional_inline}}
+
boolean. Si les onglets sont épinglés.
+
status{{optional_inline}}
+
{{WebExtAPIRef('tabs.TabStatus')}}. Si les onglets ont terminé le chargement.
+
title{{optional_inline}}
+
string. Faites correspondre les titres de page à un motif.
+
url{{optional_inline}}
+
string ou array de string. Faites correspondre les onglets avec un ou plusieurs modèle de correspondance. Notez que les identificateurs de fragment ne sont pas appariés.
+
windowId{{optional_inline}}
+
integer. L'ID de la fenêtre parente, ou  {{WebExtAPIRef('windows.WINDOW_ID_CURRENT')}} pour la fenêtre en cours.
+
windowType{{optional_inline}}
+
{{WebExtAPIRef('tabs.WindowType')}}. Le type de fenêtre dans lequel les onglets y  sont.
+
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un tableau d'objets {{WebExtAPIRef('tabs.Tab')}}, contenant des informations sur chaque onglet correspondant. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Obtenez tous les onglets :

+ +
function logTabs(tabs) {
+  for (let tab of tabs) {
+    // tab.url requires the `tabs` permission
+    console.log(tab.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var querying = browser.tabs.query({});
+querying.then(logTabs, onError);
+ +

Obtenez tous les onglets dans la fenêtre actuelle :

+ +
function logTabs(tabs) {
+  for (let tab of tabs) {
+    // tab.url requires the `tabs` permission
+    console.log(tab.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var querying = browser.tabs.query({currentWindow: true});
+querying.then(logTabs, onError);
+ +

Obtenez l'onglet actif dans la fenêtre actuelle :

+ +
function logTabs(tabs) {
+  for (let tab of tabs) {
+    // tab.url requires the `tabs` permission
+    console.log(tab.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var querying = browser.tabs.query({currentWindow: true, active: true});
+querying.then(logTabs, onError);
+ +

Obtenez des onglets pour toutes les URL HTTP et HTTPS sous "mozilla.org" ou l'un de ses sous-domaines :

+ +
function logTabs(tabs) {
+  for (let tab of tabs) {
+    // tab.url requires the `tabs` permission
+    console.log(tab.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var querying = browser.tabs.query({url: "*://*.mozilla.org/*"});
+querying.then(logTabs, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.html deleted file mode 100644 index af9306d5fa..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.html +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: tabs.reload() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/reload -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - reload - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/reload ---- -
{{AddonSidebar()}}
- -

Rechargez un onglet, en contournant éventuellement le cache Web local.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var reloading = browser.tabs.reload(
-  tabId,            // optional integer
-  reloadProperties  // optional object
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet à recharger. Par défaut à l'onglet sélectionné de la fenêtre en cours.
-
reloadProperties{{optional_inline}}
-

object.

-
-
bypassCache{{optional_inline}}
-
boolean. Contourner le cache web local. La valeur par défaut est false.
-
-
-
- -

Valeur retournée

- -

Une Promise qui sera remplie sans arguments lorsque l'onglet a été rechargé. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Recharger l'onglet actif de la fenêtre en cours :

- -
browser.tabs.reload();
- -

Rechargez l'onglet actif de la fenêtre en cours, en ignorant le cache :

- -
browser.tabs.reload({bypassCache: true});
- -

Rechargez l'onglet dont l'ID est 2, en ignorant le cache et en appelant un rappel lorsque vous avez terminé :

- -
function onReloaded() {
-  console.log(`Reloaded`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var reloading = browser.tabs.reload(2, {bypassCache: true});
-reloading.then(onReloaded, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md new file mode 100644 index 0000000000..af9306d5fa --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/reload/index.md @@ -0,0 +1,113 @@ +--- +title: tabs.reload() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/reload +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - reload + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/reload +--- +
{{AddonSidebar()}}
+ +

Rechargez un onglet, en contournant éventuellement le cache Web local.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var reloading = browser.tabs.reload(
+  tabId,            // optional integer
+  reloadProperties  // optional object
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet à recharger. Par défaut à l'onglet sélectionné de la fenêtre en cours.
+
reloadProperties{{optional_inline}}
+

object.

+
+
bypassCache{{optional_inline}}
+
boolean. Contourner le cache web local. La valeur par défaut est false.
+
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans arguments lorsque l'onglet a été rechargé. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Recharger l'onglet actif de la fenêtre en cours :

+ +
browser.tabs.reload();
+ +

Rechargez l'onglet actif de la fenêtre en cours, en ignorant le cache :

+ +
browser.tabs.reload({bypassCache: true});
+ +

Rechargez l'onglet dont l'ID est 2, en ignorant le cache et en appelant un rappel lorsque vous avez terminé :

+ +
function onReloaded() {
+  console.log(`Reloaded`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var reloading = browser.tabs.reload(2, {bypassCache: true});
+reloading.then(onReloaded, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.html deleted file mode 100644 index 90deff9f09..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: tabs.remove() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/remove -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - remove - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/remove ---- -
{{AddonSidebar()}}
- -

Ferme un ou plusieurs onglets.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var removing = browser.tabs.remove(
-  tabIds          // integer or integer array
-)
-
- -

Paramètres

- -
-
tabIds
-
integer or array of integer. Les identifiants de l'onglet ou des onglets à fermer.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie sans arguments lorsque tous les onglets spécifiés ont été supprimés ou que leurs invites beforeunload ont été traitées. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Fermer un seul onglet :

- -
function onRemoved() {
-  console.log(`Removed`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var removing = browser.tabs.remove(2);
-removing.then(onRemoved, onError);
- -

Fermer plusieurs onglets :

- -
function onRemoved() {
-  console.log(`Removed`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var removing = browser.tabs.remove([15, 14, 1]);
-removing.then(onRemoved, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md new file mode 100644 index 0000000000..90deff9f09 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/remove/index.md @@ -0,0 +1,110 @@ +--- +title: tabs.remove() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/remove +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - remove + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/remove +--- +
{{AddonSidebar()}}
+ +

Ferme un ou plusieurs onglets.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var removing = browser.tabs.remove(
+  tabIds          // integer or integer array
+)
+
+ +

Paramètres

+ +
+
tabIds
+
integer or array of integer. Les identifiants de l'onglet ou des onglets à fermer.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans arguments lorsque tous les onglets spécifiés ont été supprimés ou que leurs invites beforeunload ont été traitées. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Fermer un seul onglet :

+ +
function onRemoved() {
+  console.log(`Removed`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var removing = browser.tabs.remove(2);
+removing.then(onRemoved, onError);
+ +

Fermer plusieurs onglets :

+ +
function onRemoved() {
+  console.log(`Removed`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var removing = browser.tabs.remove([15, 14, 1]);
+removing.then(onRemoved, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.html deleted file mode 100644 index 42cc08592e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: tabs.removeCSS() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS -tags: - - API - - Add-ons - - Extensions - - Mehod - - Non-standard - - Reference - - WebExtensions - - removeCSS - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS ---- -
{{AddonSidebar()}}
- -

Supprime d'une page CSS précédemment injectée par un appel à {{WebExtAPIRef("tabs.insertCSS()")}}.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var removing = browser.tabs.removeCSS(
-  tabId,           // optional integer
-  details          // object
-)
-
- -

Paramètres

- -
-
tabId {{optional_inline}}
-
integer. L'ID de l'onglet à partir duquel supprimer le CSS. Par défaut à l'onglet actif de la fenêtre en cours.
-
details
-
Un objet décrivant le CSS à retirer de la page. Il contient les propriétés suivantes : -
-
-
allFrames{{optional_inline}}
-
boolean. si true, le code sera supprimé de toutes les images de la page en cours. si c'est false, le code est seulement retiré du cadre supérieur. Par défaut à false.
-
code{{optional_inline}}
-
string. CSS à supprimer, en tant que chaîne de texte. Cela doit correspondre exactement à une chaîne CSS précédemment insérée dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.
-
cssOrigin{{optional_inline}}
-
string. Cela peut prendre l'une des deux valeurs suivantes : "user", pour CSS ajouté en tant que feuille de style utilisateur, ou "author" pour CSS ajouté en tant que feuille de style auteur. Si cette option a été définie précédemment par  {{WebExtAPIRef("tabs.insertCSS()")}}, elle doit correspondre exactement.
-
file{{optional_inline}}
-
string. Chemin d'accès à un fichier contenant le CSS à supprimer. Cela doit correspondre exactement à un fichier CSS préalablement inséré dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.
-
frameId{{optional_inline}}
-
integer. Le cadre à partir duquel supprimer le CSS. La valeur par défaut est 0 (l'image de niveau supérieur).
-
matchAboutBlank{{optional_inline}}
-
boolean. si true, le CSS sera supprimé des cadres "about:blank" et "about:srcdoc" intégrés si votre extension a accès à leur document parent. Par défaut à false.
-
-
-
- -

Valeur retournée

- -

Une Promise qui sera remplie sans arguments lorsque tous les CSS ont été supprimés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Cet exemple ajoute du code CSS en utilisant {{WebExtAPIRef("tabs.insertCSS")}}, puis le supprime à nouveau lorsque l'utilisateur clique sur une action du navigateur :

- -
var css = "body { border: 20px dotted pink; }";
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var insertingCSS = browser.tabs.insertCSS(2, {code: css});
-insertingCSS.then(null, onError);
-
-browser.browserAction.onClicked.addListener(() => {
-  var removing = browser.tabs.removeCSS(2, {code: css});
-  removing.then(null, onError);
-});
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md new file mode 100644 index 0000000000..42cc08592e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/removecss/index.md @@ -0,0 +1,119 @@ +--- +title: tabs.removeCSS() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS +tags: + - API + - Add-ons + - Extensions + - Mehod + - Non-standard + - Reference + - WebExtensions + - removeCSS + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS +--- +
{{AddonSidebar()}}
+ +

Supprime d'une page CSS précédemment injectée par un appel à {{WebExtAPIRef("tabs.insertCSS()")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var removing = browser.tabs.removeCSS(
+  tabId,           // optional integer
+  details          // object
+)
+
+ +

Paramètres

+ +
+
tabId {{optional_inline}}
+
integer. L'ID de l'onglet à partir duquel supprimer le CSS. Par défaut à l'onglet actif de la fenêtre en cours.
+
details
+
Un objet décrivant le CSS à retirer de la page. Il contient les propriétés suivantes : +
+
+
allFrames{{optional_inline}}
+
boolean. si true, le code sera supprimé de toutes les images de la page en cours. si c'est false, le code est seulement retiré du cadre supérieur. Par défaut à false.
+
code{{optional_inline}}
+
string. CSS à supprimer, en tant que chaîne de texte. Cela doit correspondre exactement à une chaîne CSS précédemment insérée dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.
+
cssOrigin{{optional_inline}}
+
string. Cela peut prendre l'une des deux valeurs suivantes : "user", pour CSS ajouté en tant que feuille de style utilisateur, ou "author" pour CSS ajouté en tant que feuille de style auteur. Si cette option a été définie précédemment par  {{WebExtAPIRef("tabs.insertCSS()")}}, elle doit correspondre exactement.
+
file{{optional_inline}}
+
string. Chemin d'accès à un fichier contenant le CSS à supprimer. Cela doit correspondre exactement à un fichier CSS préalablement inséré dans la page en utilisant {{WebExtAPIRef("tabs.insertCSS()")}}.
+
frameId{{optional_inline}}
+
integer. Le cadre à partir duquel supprimer le CSS. La valeur par défaut est 0 (l'image de niveau supérieur).
+
matchAboutBlank{{optional_inline}}
+
boolean. si true, le CSS sera supprimé des cadres "about:blank" et "about:srcdoc" intégrés si votre extension a accès à leur document parent. Par défaut à false.
+
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans arguments lorsque tous les CSS ont été supprimés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Cet exemple ajoute du code CSS en utilisant {{WebExtAPIRef("tabs.insertCSS")}}, puis le supprime à nouveau lorsque l'utilisateur clique sur une action du navigateur :

+ +
var css = "body { border: 20px dotted pink; }";
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var insertingCSS = browser.tabs.insertCSS(2, {code: css});
+insertingCSS.then(null, onError);
+
+browser.browserAction.onClicked.addListener(() => {
+  var removing = browser.tabs.removeCSS(2, {code: css});
+  removing.then(null, onError);
+});
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.html deleted file mode 100644 index c13d1cfeae..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: tabs.saveAsPDF() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/saveAsPDF -tags: - - API - - Add-ons - - Extensions - - Méthode - - Reference - - WebExtensions - - saveAsPDF - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/saveAsPDF ---- -
{{AddonSidebar()}}
- -

Enregistre la page en cours en tant que fichier PDF. Cela ouvrira une boîte de dialogue, fournie par le système d'exploitation sous-jacent, demandant à l'utilisateur où il veut enregistrer le fichier PDF.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var saving = browser.tabs.saveAsPDF(
-  pageSettings   // object
-)
-
- -

Paramètres

- -
-
pageSettings
-
object. Paramètres de la page enregistrée, en tant qu'objet  {{WebExtAPIRef("tabs.PageSettings")}}. Cet objet doit être donné, mais toutes ses propriétés sont facultatives. Toutes les propriétés non spécifiées ici recevront les valeurs par défaut répertoriées dans la documentation  {{WebExtAPIRef("tabs.PageSettings", "PageSettings")}}.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec une chaîne d'état lorsque la boîte de dialogue sera fermée. La chaîne peut être l'une des :

- - - -

Exemples

- -

Dans cet exemple, un script d'arrière-plan écoute un clic sur une action du navigateur, puis tente d'enregistrer l'onglet actif en tant que fichier PDF, puis enregistre le résultat:

- -
browser.browserAction.onClicked.addListener(() => {
-  browser.tabs.saveAsPDF({})
-    .then((status) => {
-      console.log(status);
-    });
-});
- -

Compatibilité du navigateur

- -

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md new file mode 100644 index 0000000000..c13d1cfeae --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/saveaspdf/index.md @@ -0,0 +1,60 @@ +--- +title: tabs.saveAsPDF() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/saveAsPDF +tags: + - API + - Add-ons + - Extensions + - Méthode + - Reference + - WebExtensions + - saveAsPDF + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/saveAsPDF +--- +
{{AddonSidebar()}}
+ +

Enregistre la page en cours en tant que fichier PDF. Cela ouvrira une boîte de dialogue, fournie par le système d'exploitation sous-jacent, demandant à l'utilisateur où il veut enregistrer le fichier PDF.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var saving = browser.tabs.saveAsPDF(
+  pageSettings   // object
+)
+
+ +

Paramètres

+ +
+
pageSettings
+
object. Paramètres de la page enregistrée, en tant qu'objet  {{WebExtAPIRef("tabs.PageSettings")}}. Cet objet doit être donné, mais toutes ses propriétés sont facultatives. Toutes les propriétés non spécifiées ici recevront les valeurs par défaut répertoriées dans la documentation  {{WebExtAPIRef("tabs.PageSettings", "PageSettings")}}.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec une chaîne d'état lorsque la boîte de dialogue sera fermée. La chaîne peut être l'une des :

+ + + +

Exemples

+ +

Dans cet exemple, un script d'arrière-plan écoute un clic sur une action du navigateur, puis tente d'enregistrer l'onglet actif en tant que fichier PDF, puis enregistre le résultat:

+ +
browser.browserAction.onClicked.addListener(() => {
+  browser.tabs.saveAsPDF({})
+    .then((status) => {
+      console.log(status);
+    });
+});
+ +

Compatibilité du navigateur

+ +

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.html deleted file mode 100644 index 02c287215f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.html +++ /dev/null @@ -1,145 +0,0 @@ ---- -title: tabs.sendMessage() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/sendMessage -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - onglets - - sendMessage - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendMessage ---- -
{{AddonSidebar()}}
- -
Envoi un message unique depuis le script d'arrière plan d'extension (ou autre scripts accrédité, comme les scripts popup ou les scripts de page d'options) vers n'importe quel script de contenu concerné par l'extension et qui s'execute dans l'onglet spécifié.
- -
Ce message sera reçu dans script de contenu par n'importe quel gestionnaire d'évènements à l'écoute de l'évènement
- -

{{WebExtAPIRef("runtime.onMessage")}}. Les gestionnaires d'évènements peuvent optionellement envoyé une réponse en retour au script d'arrière plan en utilisant l'argument sendResponse.

- -

Il s'agit d'une fonction asynchrone qui renvoit un objet Promise.

- -
-

Note : Vous pouvez également utiliser une approche basée sur la connexion pour échanger des messages.

-
- - - -

Syntaxe

- -
var sending = browser.tabs.sendMessage(
-  tabId,                   // integer
-  message,                 // any
-  options                  // optional object
-)
-
- -

Paramètres

- -
-
tabId
-
integer. ID de l'onglet qui contient le script de contenu auquel on veut envoyer un message.
-
message
-
any. Un objet qui peut être sérialisé en JSON.
-
options{{optional_inline}}
-

object.

-
-
frameId{{optional_inline}}
-
integer.  Envoie le message à un cadre (iframe) spécifique identifiée par frameId au lieu de tous les cadres de l'onglet. Le fait que le script de contenu soit exécuté dans tous les cadres dépend du paramètre all_frames dans la section  content_scripts de manifest.json.
-
-
-
- -

Valeur renvoyée

- -

Un objet Promise qui sera rempli avec une réponse objet au format JSON envoyé par le gestionnaire de message dans le script de contenu, ou sans arguments si le script de contenu n'a pas renvoyé de réponses. Si une erreur survient durant la connexion avec l'onglet spécifié, ou si n'importe quelle erreur survient, la promesse sera rejeté avec un message d'erreur. Si plusieurs trames répondent au message, la promesse est résolue en une des réponses

- -

Exemples

- -

Voici un exemple de script d'arrière plan qui envoi un message au script de contenu qui s'execute dans l'onglet actif quand le client clique sur l'icone de l'extension. Le script d'arrière plan s'attend également que le script de contenu lui renvoit une réponse:

- -
// background-script.js
-"use strict";
-
-function onError(error) {
-  console.error(`Error: ${error}`);
-}
-
-function sendMessageToTabs(tabs) {
-  for (let tab of tabs) {
-    browser.tabs.sendMessage(
-      tab.id,
-      {greeting: "Hi from background script"}
-    ).then(response => {
-      console.log("Message from the content script:");
-      console.log(response.response);
-    }).catch(onError);
-  }
-}
-
-browser.browserAction.onClicked.addListener(() => {
-  browser.tabs.query({
-    currentWindow: true,
-    active: true
-  }).then(sendMessageToTabs).catch(onError);
-});
- -

Voici le script de contenu associé:

- -
// content-script.js
-"use strict";
-
-browser.runtime.onMessage.addListener(request => {
-  console.log("Message from the background script:");
-  console.log(request.greeting);
-  return Promise.resolve({response: "Hi from content script"});
-});
- -

{{WebExtExamples}}

- -

Compatiblité des navigateurs

- -

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

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md new file mode 100644 index 0000000000..02c287215f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendmessage/index.md @@ -0,0 +1,145 @@ +--- +title: tabs.sendMessage() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/sendMessage +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - onglets + - sendMessage + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendMessage +--- +
{{AddonSidebar()}}
+ +
Envoi un message unique depuis le script d'arrière plan d'extension (ou autre scripts accrédité, comme les scripts popup ou les scripts de page d'options) vers n'importe quel script de contenu concerné par l'extension et qui s'execute dans l'onglet spécifié.
+ +
Ce message sera reçu dans script de contenu par n'importe quel gestionnaire d'évènements à l'écoute de l'évènement
+ +

{{WebExtAPIRef("runtime.onMessage")}}. Les gestionnaires d'évènements peuvent optionellement envoyé une réponse en retour au script d'arrière plan en utilisant l'argument sendResponse.

+ +

Il s'agit d'une fonction asynchrone qui renvoit un objet Promise.

+ +
+

Note : Vous pouvez également utiliser une approche basée sur la connexion pour échanger des messages.

+
+ + + +

Syntaxe

+ +
var sending = browser.tabs.sendMessage(
+  tabId,                   // integer
+  message,                 // any
+  options                  // optional object
+)
+
+ +

Paramètres

+ +
+
tabId
+
integer. ID de l'onglet qui contient le script de contenu auquel on veut envoyer un message.
+
message
+
any. Un objet qui peut être sérialisé en JSON.
+
options{{optional_inline}}
+

object.

+
+
frameId{{optional_inline}}
+
integer.  Envoie le message à un cadre (iframe) spécifique identifiée par frameId au lieu de tous les cadres de l'onglet. Le fait que le script de contenu soit exécuté dans tous les cadres dépend du paramètre all_frames dans la section  content_scripts de manifest.json.
+
+
+
+ +

Valeur renvoyée

+ +

Un objet Promise qui sera rempli avec une réponse objet au format JSON envoyé par le gestionnaire de message dans le script de contenu, ou sans arguments si le script de contenu n'a pas renvoyé de réponses. Si une erreur survient durant la connexion avec l'onglet spécifié, ou si n'importe quelle erreur survient, la promesse sera rejeté avec un message d'erreur. Si plusieurs trames répondent au message, la promesse est résolue en une des réponses

+ +

Exemples

+ +

Voici un exemple de script d'arrière plan qui envoi un message au script de contenu qui s'execute dans l'onglet actif quand le client clique sur l'icone de l'extension. Le script d'arrière plan s'attend également que le script de contenu lui renvoit une réponse:

+ +
// background-script.js
+"use strict";
+
+function onError(error) {
+  console.error(`Error: ${error}`);
+}
+
+function sendMessageToTabs(tabs) {
+  for (let tab of tabs) {
+    browser.tabs.sendMessage(
+      tab.id,
+      {greeting: "Hi from background script"}
+    ).then(response => {
+      console.log("Message from the content script:");
+      console.log(response.response);
+    }).catch(onError);
+  }
+}
+
+browser.browserAction.onClicked.addListener(() => {
+  browser.tabs.query({
+    currentWindow: true,
+    active: true
+  }).then(sendMessageToTabs).catch(onError);
+});
+ +

Voici le script de contenu associé:

+ +
// content-script.js
+"use strict";
+
+browser.runtime.onMessage.addListener(request => {
+  console.log("Message from the background script:");
+  console.log(request.greeting);
+  return Promise.resolve({response: "Hi from content script"});
+});
+ +

{{WebExtExamples}}

+ +

Compatiblité des navigateurs

+ +

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

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.html deleted file mode 100644 index a1c4fea52c..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: tabs.sendRequest() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/sendRequest -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - sendRequest - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendRequest ---- -
{{AddonSidebar()}}
- -
-

Attention : Cette méthode a été dépréciée. Utilisez {{WebExtAPIRef("tabs.sendMessage()")}} à la place.

-
- -

Envoie une seule requête au(x) script(s) de contenu dans l'onglet spécifié, avec un rappel facultatif à exécuter lorsqu'une réponse est renvoyée. L'événement {{WebExtAPIRef('extension.onRequest')}} est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension en cours.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var sending = browser.tabs.sendRequest(
-  tabId,                   // integer
-  request                  // any
-)
-
- -

Paramètres

- -
-
tabId
-
integer.
-
request
-
any.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie avec l'objet de réponse JSON envoyé par le gestionnaire du message dans le script de contenu, ou sans arguments si le script de contenu n'a pas envoyé de réponse. Si une erreur survient lors de la connexion à l'onglet spécifié ou si une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md new file mode 100644 index 0000000000..a1c4fea52c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/sendrequest/index.md @@ -0,0 +1,87 @@ +--- +title: tabs.sendRequest() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/sendRequest +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - sendRequest + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/sendRequest +--- +
{{AddonSidebar()}}
+ +
+

Attention : Cette méthode a été dépréciée. Utilisez {{WebExtAPIRef("tabs.sendMessage()")}} à la place.

+
+ +

Envoie une seule requête au(x) script(s) de contenu dans l'onglet spécifié, avec un rappel facultatif à exécuter lorsqu'une réponse est renvoyée. L'événement {{WebExtAPIRef('extension.onRequest')}} est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension en cours.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var sending = browser.tabs.sendRequest(
+  tabId,                   // integer
+  request                  // any
+)
+
+ +

Paramètres

+ +
+
tabId
+
integer.
+
request
+
any.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec l'objet de réponse JSON envoyé par le gestionnaire du message dans le script de contenu, ou sans arguments si le script de contenu n'a pas envoyé de réponse. Si une erreur survient lors de la connexion à l'onglet spécifié ou si une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.html deleted file mode 100644 index e8d668c96f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: tabs.setZoom() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/setZoom -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - setZoom - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/setZoom ---- -
{{AddonSidebar()}}
- -

Effectue un zoom sur l'onglet spécifié.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var zooming = browser.tabs.setZoom(
-  tabId,           // optional integer
-  zoomFactor       // number
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet à zoomer. Par défaut à l'onglet actif de la fenêtre en cours.
-
zoomFactor
-
number. Le nouveau facteur de zoom. Utilisez une valeur de 0 ici pour régler l'onglet à son facteur de zoom par défaut actuel. Sinon, il doit s'agir d'un nombre compris entre 0,3 et 3, en spécifiant un facteur de zoom.
-
- -

Valeur retournée

- -

Une Promise cela sera accompli sans arguments après que le facteur de zoom ait été changé. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Set the zoom factor for the current tab to 2:

- -
function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var setting = browser.tabs.setZoom(2);
-setting.then(null, onError);
- -

Set the zoom factor for the tab whose ID is 16 tab to 0.5:

- -
function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var setting = browser.tabs.setZoom(16, 0.5);
-setting.then(null, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md new file mode 100644 index 0000000000..e8d668c96f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoom/index.md @@ -0,0 +1,105 @@ +--- +title: tabs.setZoom() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/setZoom +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - setZoom + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/setZoom +--- +
{{AddonSidebar()}}
+ +

Effectue un zoom sur l'onglet spécifié.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var zooming = browser.tabs.setZoom(
+  tabId,           // optional integer
+  zoomFactor       // number
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet à zoomer. Par défaut à l'onglet actif de la fenêtre en cours.
+
zoomFactor
+
number. Le nouveau facteur de zoom. Utilisez une valeur de 0 ici pour régler l'onglet à son facteur de zoom par défaut actuel. Sinon, il doit s'agir d'un nombre compris entre 0,3 et 3, en spécifiant un facteur de zoom.
+
+ +

Valeur retournée

+ +

Une Promise cela sera accompli sans arguments après que le facteur de zoom ait été changé. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Set the zoom factor for the current tab to 2:

+ +
function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var setting = browser.tabs.setZoom(2);
+setting.then(null, onError);
+ +

Set the zoom factor for the tab whose ID is 16 tab to 0.5:

+ +
function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var setting = browser.tabs.setZoom(16, 0.5);
+setting.then(null, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.html deleted file mode 100644 index 626942a3fb..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: tabs.setZoomSettings() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/setZoomSettings -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - setZoomSettings - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/setZoomSettings ---- -
{{AddonSidebar()}}
- -

Définit les paramètres de zoom pour l'onglet spécifié. Ces paramètres sont réinitialisés aux paramètres par défaut lors de la navigation dans l'onglet.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var settingZoomSettings = browser.tabs.setZoomSettings(
-  tabId,           // optional integer
-  zoomSettings     // ZoomSettings
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet pour modifier les paramètres de zoom pour. Par défaut à l'onglet actif de la fenêtre en cours.
-
zoomSettings
-
{{WebExtAPIRef('tabs.ZoomSettings')}}. Définit comment les modifications de zoom sont gérées et à quelle portée.
-
- -

Valeur retournée

- -

une Promise qui sera remplie sans arguments après que les paramètres de zoom ont été modifiés. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Désactiver le zoom pour l'onglet actuel :

- -
function onSet() {
-  console.log(`Set zoom factor`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var setting = browser.tabs.setZoomSettings({mode:"disabled"});
-setting.then(onSet, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md new file mode 100644 index 0000000000..626942a3fb --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/setzoomsettings/index.md @@ -0,0 +1,100 @@ +--- +title: tabs.setZoomSettings() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/setZoomSettings +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - setZoomSettings + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/setZoomSettings +--- +
{{AddonSidebar()}}
+ +

Définit les paramètres de zoom pour l'onglet spécifié. Ces paramètres sont réinitialisés aux paramètres par défaut lors de la navigation dans l'onglet.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var settingZoomSettings = browser.tabs.setZoomSettings(
+  tabId,           // optional integer
+  zoomSettings     // ZoomSettings
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet pour modifier les paramètres de zoom pour. Par défaut à l'onglet actif de la fenêtre en cours.
+
zoomSettings
+
{{WebExtAPIRef('tabs.ZoomSettings')}}. Définit comment les modifications de zoom sont gérées et à quelle portée.
+
+ +

Valeur retournée

+ +

une Promise qui sera remplie sans arguments après que les paramètres de zoom ont été modifiés. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Désactiver le zoom pour l'onglet actuel :

+ +
function onSet() {
+  console.log(`Set zoom factor`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var setting = browser.tabs.setZoomSettings({mode:"disabled"});
+setting.then(onSet, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.html deleted file mode 100644 index 5f78d0937c..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: tabs.show() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/show -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - show - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/show ---- -
{{AddonSidebar()}}
- -

Affiche un ou plusieurs onglets précédemment masqués par un appel à {{WebExtAPIRef("tabs.hide")}}.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var showing = browser.tabs.show(
-  tabIds          // integer or integer array
-)
-
- -

Paramètres

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

Valeur retournée

- -

Une Promise qui sera accomplie sans arguments. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Afficher un seul onglet :

- -
function onShown() {
-  console.log(`Shown`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.tabs.show(2).then(onShown, onError);
- -

Afficher plusieurs onglets :

- -
function onShown() {
-  console.log(`Shown`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-browser.tabs.show([15, 14, 1]).then(onShown, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md new file mode 100644 index 0000000000..5f78d0937c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/show/index.md @@ -0,0 +1,69 @@ +--- +title: tabs.show() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/show +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - show + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/show +--- +
{{AddonSidebar()}}
+ +

Affiche un ou plusieurs onglets précédemment masqués par un appel à {{WebExtAPIRef("tabs.hide")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var showing = browser.tabs.show(
+  tabIds          // integer or integer array
+)
+
+ +

Paramètres

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

Valeur retournée

+ +

Une Promise qui sera accomplie sans arguments. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Afficher un seul onglet :

+ +
function onShown() {
+  console.log(`Shown`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+browser.tabs.show(2).then(onShown, onError);
+ +

Afficher plusieurs onglets :

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

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.html deleted file mode 100644 index b6f12e9c87..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.html +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: tabs.Tab -slug: Mozilla/Add-ons/WebExtensions/API/tabs/Tab -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Tab - - Type - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab ---- -
{{AddonSidebar()}}
- -

Le type tabs.Tab contient des informations sur un onglet. Cela donne accès à des informations sur le contenu de l'onglet, la taille du contenu, les états spéciaux ou les restrictions en vigueur, etc.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
active
-

boolean. Si l'onglet est actif dans sa fenêtre. Ceci peut être vrai même si la fenêtre de l'onglet n'est pas actuellement focalisée.

-

L'onglet actif est généralement l'onglet sélectionné. Cependant, sur Firefox pour Android, les popups d'extension s'ouvrent dans un nouvel onglet. Lorsque cet onglet popup est sélectionné, l'onglet actif sera plutôt celui dans lequel le popup s'est ouvert.

-
attention {{optional_inline}}
-
boolean. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, attention sera à true.
-
audible {{optional_inline}}
-
boolean. Si l'onglet n'est pas coupé: si l'onglet produit du son. Si l'onglet est coupé: si l'onglet produit un son, s'il n'est pas muet.
-
autoDiscardable {{optional_inline}}
-
boolean. Si l'onglet peut être supprimé automatiquement par le navigateur lorsque les ressources sont faibles.
-
cookieStoreId {{optional_inline}}
-
string. Le magasin de cookies de l'onglet. Si différents onglets peuvent avoir différents magasins de cookies (par exemple, pour prendre en charge l'identitié contextuelle), vous pouvez passer cette option storeId dans différentes méthodes de l'API {{WebExtAPIRef("cookies")}}, pour définir et obtenir des cookies associés à Le magasin de cookies de cet onglet. Seulement présent si l'extension a la permission "cookies".
-
discarded {{optional_inline}}
-
boolean. Si l'onglet est ignoré. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.
-
favIconUrl {{optional_inline}}
-
string. L'URL de la favicon de l'onglet. Seulement présent si l'extension a la permission "tabs". Il peut également s'agir d'une chaîne vide si l'onglet est en cours de chargement.
-
height {{optional_inline}}
-
integer. La hauteur de l'onglet en pixels.
-
hidden
-
boolean. Si l'onglet est caché.
-
highlighted
-

boolean. Si l'onglet est en surbrillance, c'est-à-dire une partie de la sélection de l'onglet en cours. Un onglet actif est toujours mis en surbrillance, mais certains navigateurs peuvent permettre de mettre en surbrillance des onglets supplémentaires, par exemple en cliquant dessus tout en maintenant les touches Ctrl, Shift ou ⌘ Command .

-

Firefox pour Android ne prend pas en charge la mise en surbrillance de plusieurs onglets, et le bureau Firefox nécessite la préférence  browser.tabs.multiselect (activé par défaut).

-
id {{optional_inline}}
-
integer. L'ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. L'ID d'onglet peut également être défini sur  {{WebExtAPIRef('tabs.TAB_ID_NONE')}} pour les fenêtres de navigateur qui n'hébergent pas d'onglets de contenu (par exemple, les fenêtres devtools).
-
incognito
-
boolean. Si l'onglet est dans une fenêtre de navigation privée.
-
index
-
integer. L'indice de base zéro de l'onglet dans sa fenêtre.
-
isArticle
-
boolean. Vrai si l'onglet peut être rendu en mode lecteur, sinon faux.
-
isInReaderMode
-
boolean. Vrai si l'onglet en cours de rendu en mode lecteur, sinon faux.
-
lastAccessed
-
double. Heure à laquelle l'onglet a été accédé pour la dernière fois, en millisecondes depuis l'époque.
-
mutedInfo {{optional_inline}}
-
{{WebExtAPIRef('tabs.MutedInfo')}}. L'état en sourdine actuel pour l'onglet et la raison du dernier changement d'état.
-
openerTabId {{optional_inline}}
-
integer. L'ID de l'onglet qui a ouvert cet onglet, le cas échéant. Cette propriété n'est présente que si l'onglet d'ouverture existe toujours.
-
pinned
-
boolean. Si l'onglet est épinglé.
-
selected {{deprecated_inline}}
-
boolean. Si l'onglet est sélectionné. Cette propriété a été remplacée par active et highlighted.
-
sessionId {{optional_inline}}
-
string. L'identifiant de session utilisé pour identifier de façon unique un onglet  obtenu à partir de l'API {{WebExtAPIRef('sessions')}}.
-
status {{optional_inline}}
-
string. Soit charger ou compléter.
-
successorId {{optional_inline}}
-
integer L'ID du successeur de l'onglet.
-
title {{optional_inline}}
-
string. Le titre de l'onglet. Seulement présent si l'extension à la permission "tabs".
-
url {{optional_inline}}
-
string. L'URL du document que l'onglet affiche. Seulement présent si l'extension à la permission "tabs".
-
width {{optional_inline}}
-
integer. La largeur de l'onglet en pixels
-
windowId
-
integer. L'ID de la fenêtre qui héberge cet onglet.**
-
- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.Tab", 10)}}

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md new file mode 100644 index 0000000000..b6f12e9c87 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab/index.md @@ -0,0 +1,125 @@ +--- +title: tabs.Tab +slug: Mozilla/Add-ons/WebExtensions/API/tabs/Tab +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Tab + - Type + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/Tab +--- +
{{AddonSidebar()}}
+ +

Le type tabs.Tab contient des informations sur un onglet. Cela donne accès à des informations sur le contenu de l'onglet, la taille du contenu, les états spéciaux ou les restrictions en vigueur, etc.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
active
+

boolean. Si l'onglet est actif dans sa fenêtre. Ceci peut être vrai même si la fenêtre de l'onglet n'est pas actuellement focalisée.

+

L'onglet actif est généralement l'onglet sélectionné. Cependant, sur Firefox pour Android, les popups d'extension s'ouvrent dans un nouvel onglet. Lorsque cet onglet popup est sélectionné, l'onglet actif sera plutôt celui dans lequel le popup s'est ouvert.

+
attention {{optional_inline}}
+
boolean. Indique si l'onglet attire l'attention. Par exemple, lorsque l'onglet affiche un dialogue modal, attention sera à true.
+
audible {{optional_inline}}
+
boolean. Si l'onglet n'est pas coupé: si l'onglet produit du son. Si l'onglet est coupé: si l'onglet produit un son, s'il n'est pas muet.
+
autoDiscardable {{optional_inline}}
+
boolean. Si l'onglet peut être supprimé automatiquement par le navigateur lorsque les ressources sont faibles.
+
cookieStoreId {{optional_inline}}
+
string. Le magasin de cookies de l'onglet. Si différents onglets peuvent avoir différents magasins de cookies (par exemple, pour prendre en charge l'identitié contextuelle), vous pouvez passer cette option storeId dans différentes méthodes de l'API {{WebExtAPIRef("cookies")}}, pour définir et obtenir des cookies associés à Le magasin de cookies de cet onglet. Seulement présent si l'extension a la permission "cookies".
+
discarded {{optional_inline}}
+
boolean. Si l'onglet est ignoré. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.
+
favIconUrl {{optional_inline}}
+
string. L'URL de la favicon de l'onglet. Seulement présent si l'extension a la permission "tabs". Il peut également s'agir d'une chaîne vide si l'onglet est en cours de chargement.
+
height {{optional_inline}}
+
integer. La hauteur de l'onglet en pixels.
+
hidden
+
boolean. Si l'onglet est caché.
+
highlighted
+

boolean. Si l'onglet est en surbrillance, c'est-à-dire une partie de la sélection de l'onglet en cours. Un onglet actif est toujours mis en surbrillance, mais certains navigateurs peuvent permettre de mettre en surbrillance des onglets supplémentaires, par exemple en cliquant dessus tout en maintenant les touches Ctrl, Shift ou ⌘ Command .

+

Firefox pour Android ne prend pas en charge la mise en surbrillance de plusieurs onglets, et le bureau Firefox nécessite la préférence  browser.tabs.multiselect (activé par défaut).

+
id {{optional_inline}}
+
integer. L'ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. L'ID d'onglet peut également être défini sur  {{WebExtAPIRef('tabs.TAB_ID_NONE')}} pour les fenêtres de navigateur qui n'hébergent pas d'onglets de contenu (par exemple, les fenêtres devtools).
+
incognito
+
boolean. Si l'onglet est dans une fenêtre de navigation privée.
+
index
+
integer. L'indice de base zéro de l'onglet dans sa fenêtre.
+
isArticle
+
boolean. Vrai si l'onglet peut être rendu en mode lecteur, sinon faux.
+
isInReaderMode
+
boolean. Vrai si l'onglet en cours de rendu en mode lecteur, sinon faux.
+
lastAccessed
+
double. Heure à laquelle l'onglet a été accédé pour la dernière fois, en millisecondes depuis l'époque.
+
mutedInfo {{optional_inline}}
+
{{WebExtAPIRef('tabs.MutedInfo')}}. L'état en sourdine actuel pour l'onglet et la raison du dernier changement d'état.
+
openerTabId {{optional_inline}}
+
integer. L'ID de l'onglet qui a ouvert cet onglet, le cas échéant. Cette propriété n'est présente que si l'onglet d'ouverture existe toujours.
+
pinned
+
boolean. Si l'onglet est épinglé.
+
selected {{deprecated_inline}}
+
boolean. Si l'onglet est sélectionné. Cette propriété a été remplacée par active et highlighted.
+
sessionId {{optional_inline}}
+
string. L'identifiant de session utilisé pour identifier de façon unique un onglet  obtenu à partir de l'API {{WebExtAPIRef('sessions')}}.
+
status {{optional_inline}}
+
string. Soit charger ou compléter.
+
successorId {{optional_inline}}
+
integer L'ID du successeur de l'onglet.
+
title {{optional_inline}}
+
string. Le titre de l'onglet. Seulement présent si l'extension à la permission "tabs".
+
url {{optional_inline}}
+
string. L'URL du document que l'onglet affiche. Seulement présent si l'extension à la permission "tabs".
+
width {{optional_inline}}
+
integer. La largeur de l'onglet en pixels
+
windowId
+
integer. L'ID de la fenêtre qui héberge cet onglet.**
+
+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.Tab", 10)}}

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.html deleted file mode 100644 index 9ba6040cd2..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: tabs.TAB_ID_NONE -slug: Mozilla/Add-ons/WebExtensions/API/tabs/TAB_ID_NONE -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Property - - Reference - - TAB_ID_NONE - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TAB_ID_NONE ---- -
{{AddonSidebar()}}
- -

Une valeur d'ID spéciale donnée aux onglets qui ne sont pas des onglets du navigateur (par exemple, des onglets dans les fenêtres devtools).

- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md new file mode 100644 index 0000000000..9ba6040cd2 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/tab_id_none/index.md @@ -0,0 +1,62 @@ +--- +title: tabs.TAB_ID_NONE +slug: Mozilla/Add-ons/WebExtensions/API/tabs/TAB_ID_NONE +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Property + - Reference + - TAB_ID_NONE + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TAB_ID_NONE +--- +
{{AddonSidebar()}}
+ +

Une valeur d'ID spéciale donnée aux onglets qui ne sont pas des onglets du navigateur (par exemple, des onglets dans les fenêtres devtools).

+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.html deleted file mode 100644 index 3ed5059c4e..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: tabs.TabStatus -slug: Mozilla/Add-ons/WebExtensions/API/tabs/TabStatus -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - TabStatus - - Type - - WebExtensions - - tazbs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TabStatus ---- -
{{AddonSidebar()}}
- -

Indique si l'onglet a terminé le chargement.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont : "loading" et "complete".

- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md new file mode 100644 index 0000000000..3ed5059c4e --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/tabstatus/index.md @@ -0,0 +1,66 @@ +--- +title: tabs.TabStatus +slug: Mozilla/Add-ons/WebExtensions/API/tabs/TabStatus +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - TabStatus + - Type + - WebExtensions + - tazbs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/TabStatus +--- +
{{AddonSidebar()}}
+ +

Indique si l'onglet a terminé le chargement.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont : "loading" et "complete".

+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.html deleted file mode 100644 index 75547d51f4..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: tabs.toggleReaderMode() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/toggleReaderMode -tags: - - API - - Add-ons - - Extensions - - Method - - Reference - - WebExtensions - - tabs - - toogleReaderMode -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/toggleReaderMode ---- -
{{AddonSidebar()}}
- -

Bascule en mode Lecteur pour l'onglet donné.

- - - -

Cette fonction permet de basculer en mode Lecteur pour l'onglet donné. Il prend un identifiant de tabulation en tant que paramètre: s'il est omis, l'onglet actuellement actif est basculé.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Le mode Lecteur, également connu sous le nom de Reader View, est une fonction de navigateur qui permet à l'utilisateur de se concentrer plus facilement sur un article en :

- - - -

Le mode Lecteur est utile spécifiquement pour les articles: c'est-à-dire, les pages qui ont un corps de texte comme caractéristique principale. Les pages qui n'ont pas d'article identifiable ne peuvent pas être affichées en mode Lecteur. Pour savoir si une page est un article, vérifiez la propriété isArticle de {{WebExtAPIRef("tabs.Tab")}}.

- -

Pour savoir si un onglet est déjà en mode Lecteur, vérifiez la propriété  isInReaderMode de {{WebExtAPIRef("tabs.Tab")}}. Pour suivre les onglets entrant ou sortant du mode Lecteur, vous devez suivre l'état actuel de tous les onglets et vérifier quand isInReaderMode change :

- -
function handleUpdated(tabId, changeInfo, tabInfo) {
-  if (changeInfo.status === "complete") {
-    console.log(`Tab ${tabId} reader mode: ${tabInfo.isInReaderMode}`);
-  }
-}
-
-browser.tabs.onUpdated.addListener(handleUpdated);
- -

Syntaxe

- -
var toggling = browser.tabs.toggleReaderMode(
-  tabId            // optional integer
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. L'ID de l'onglet à afficher en mode Lecteur. Par défaut à l'onglet sélectionné de la fenêtre en cours.
-
- -

Valeur retournée

- -

Une Promise qui sera remplie sans argument lorsque l'onglet a été mis à jour. Si une erreur se produit (par exemple, parce que la page n'était pas un article), la promesse sera rejetée avec un message d'erreur..

- -

Exemples

- -

Ce code bascule chaque nouvelle page en mode lecteur, si cette page est éligible pour cela :

- -
function switchToReaderMode(tabId, changeInfo, tabInfo) {
-  if (changeInfo.isArticle) {
-    browser.tabs.toggleReaderMode(tabId);
-  }
-}
-
-browser.tabs.onUpdated.addListener(switchToReaderMode);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md new file mode 100644 index 0000000000..75547d51f4 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/togglereadermode/index.md @@ -0,0 +1,79 @@ +--- +title: tabs.toggleReaderMode() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/toggleReaderMode +tags: + - API + - Add-ons + - Extensions + - Method + - Reference + - WebExtensions + - tabs + - toogleReaderMode +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/toggleReaderMode +--- +
{{AddonSidebar()}}
+ +

Bascule en mode Lecteur pour l'onglet donné.

+ + + +

Cette fonction permet de basculer en mode Lecteur pour l'onglet donné. Il prend un identifiant de tabulation en tant que paramètre: s'il est omis, l'onglet actuellement actif est basculé.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Le mode Lecteur, également connu sous le nom de Reader View, est une fonction de navigateur qui permet à l'utilisateur de se concentrer plus facilement sur un article en :

+ + + +

Le mode Lecteur est utile spécifiquement pour les articles: c'est-à-dire, les pages qui ont un corps de texte comme caractéristique principale. Les pages qui n'ont pas d'article identifiable ne peuvent pas être affichées en mode Lecteur. Pour savoir si une page est un article, vérifiez la propriété isArticle de {{WebExtAPIRef("tabs.Tab")}}.

+ +

Pour savoir si un onglet est déjà en mode Lecteur, vérifiez la propriété  isInReaderMode de {{WebExtAPIRef("tabs.Tab")}}. Pour suivre les onglets entrant ou sortant du mode Lecteur, vous devez suivre l'état actuel de tous les onglets et vérifier quand isInReaderMode change :

+ +
function handleUpdated(tabId, changeInfo, tabInfo) {
+  if (changeInfo.status === "complete") {
+    console.log(`Tab ${tabId} reader mode: ${tabInfo.isInReaderMode}`);
+  }
+}
+
+browser.tabs.onUpdated.addListener(handleUpdated);
+ +

Syntaxe

+ +
var toggling = browser.tabs.toggleReaderMode(
+  tabId            // optional integer
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. L'ID de l'onglet à afficher en mode Lecteur. Par défaut à l'onglet sélectionné de la fenêtre en cours.
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie sans argument lorsque l'onglet a été mis à jour. Si une erreur se produit (par exemple, parce que la page n'était pas un article), la promesse sera rejetée avec un message d'erreur..

+ +

Exemples

+ +

Ce code bascule chaque nouvelle page en mode lecteur, si cette page est éligible pour cela :

+ +
function switchToReaderMode(tabId, changeInfo, tabInfo) {
+  if (changeInfo.isArticle) {
+    browser.tabs.toggleReaderMode(tabId);
+  }
+}
+
+browser.tabs.onUpdated.addListener(switchToReaderMode);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

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

diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.html deleted file mode 100644 index 76f37e6a2f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.html +++ /dev/null @@ -1,162 +0,0 @@ ---- -title: tabs.update() -slug: Mozilla/Add-ons/WebExtensions/API/tabs/update -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - Update - - WebExtensions - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/update ---- -
{{AddonSidebar()}}
- -

Parcourez l'onglet vers une nouvelle URL ou modifiez d'autres propriétés de l'onglet.

- -

Pour utiliser cette fonction, transmettez l'ID de l'onglet à mettre à jour et un objet updateProperties contenant les propriétés que vous souhaitez mettre à jour. Les propriétés qui ne sont pas spécifiées dans  updateProperties ne sont pas modifiées.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var updating = browser.tabs.update(
-  tabId,              // optional integer
-  updateProperties    // object
-)
-
- -

Paramètres

- -
-
tabId{{optional_inline}}
-
integer. Par défaut à l'onglet sélectionné de la fenêtre en cours.
-
updateProperties
-

object. L'ensemble des propriétés à mettre à jour pour cet onglet. Pour en savoir plus sur ces propriétés, consultez la documentation  {{WebExtAPIRef("tabs.Tab")}}.

-
-
active{{optional_inline}}
-
boolean. Si l'onglet doit devenir actif. Ne modifie pas le focus de la fenêtre (voir {{WebExtAPIRef('windows.update')}}). Si true, les onglets surlignés non actifs cesseront d'être surlignés. Si false, ne fait rien.
-
autoDiscardable{{optional_inline}}
-
boolean. Si l'onglet doit être supprimé automatiquement par le navigateur lorsque les ressources sont faibles.
-
highlighted{{optional_inline}}
-

boolean. Ajoute ou supprime l'onglet de la sélection courante. Si true et que l'onglet n'est pas surligné, il deviendra actif par défaut.

-

Si vous voulez seulement mettre en surbrillance l'onglet sans l'activer, Firefox accepte le réglage highlighted à true et active à false. D'autres navigateurs peuvent activer l'onglet même dans ce cas.

-
-
loadReplace{{optional_inline}}
-
-

boolean. Si la nouvelle URL doit remplacer l'ancienne URL dans l'historique de navigation de l'onglet, accessible via le bouton "Retour".

- -

Par exemple, supposons que l'utilisateur crée un nouvel onglet en utilisant Ctrl + T. Par défaut, dans Firefox, cela chargerait "about:newtab". Si votre extension met alors à jour cette page en utilisant {{WebExtAPIRef("tabs.update")}}, sans loadReplace, le bouton "retour" sera activé et ramènera l'utilisateur à "about:newtab". Si l'extension définit loadReplace, le bouton "retour" sera désactivé et ce sera comme si l'URL fournie par l'extension était la première page visitée dans cet onglet.

- -

Notez cependant que l'URL d'origine apparaîtra toujours dans l'historique global du navigateur.

-
-
muted{{optional_inline}}
-
boolean. Si l'onglet doit être coupé.
-
openerTabId{{optional_inline}}
-
integer. L'ID de l'onglet qui a ouvert cet onglet. Si spécifié, l'onglet d'ouverture doit être dans la même fenêtre que cet onglet.
-
pinned{{optional_inline}}
-
boolean. Si l'onglet doit être épinglé.
-
selected {{deprecated_inline}} {{optional_inline}}
-
boolean. Si l'onglet doit être sélectionné. Cette propriété a été remplacée par active et highlighted.
-
successorTabId {{optional_inline}}
-
integer. L'identifiant de l'ID du successeur de l'onglet.
-
url{{optional_inline}}
-

string. Une URL pour naviguer dans l'onglet.

Pour des raisons de sécurité, dans Firefox, il se peut que ce ne soit pas une URL privilégiée. Le passage de l'une des URL suivantes échouera, avec {{WebExtAPIRef("runtime.lastError")}} étant défini sur un message d'erreur :

-
    -
  • chrome: URLs
    • -
  • javascript: URLs
    • -
  • data: URLs
    • -
  • file: URLs (c'est-à-dire, fichiers sur le système de fichiers, cependant, pour utiliser un fichier empaqueté à l'intérieur de l'extension, voir ci-dessous)
    • -
  • confidentiel : URLs (par exemle, about:config, about:addons, about:debugging, about:newtab). Les URL non privilégiées (par exemple, about:blank) sont autorisées.
    • -
-

Pour charger une page fournie avec votre extension, spécifiez une URL absolue à partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractère '/', l'URL est traitée comme une URL relative et différents navigateurs peuvent construire différentes URL absolues.

-
-
-
- -

Valeur retournée

- -

A Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des détails sur l'onglet mis à jour. L'objet {{WebExtAPIRef('tabs.Tab')}} ne contient pas d' url, title et favIconUrl sauf si la permission "tabs" a été demandée. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

- -

Exemples

- -

Naviguez dans l'onglet actif de la fenêtre en cours pour https://developer.mozilla.org :

- -
function onUpdated(tab) {
-  console.log(`Updated tab: ${tab.id}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var updating = browser.tabs.update({url: "https://developer.mozilla.org"});
-updating.then(onUpdated, onError);
- -

Activez le premier onglet de la fenêtre actuelle et naviguez jusqu'à https://developer.mozilla.org:

- -
function onUpdated(tab) {
-  console.log(`Updated tab: ${tab.id}`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function updateFirstTab(tabs) {
-  var updating = browser.tabs.update(tabs[0].id, {
-    active: true,
-    url: "https://developer.mozilla.org"
-  });
-  updating.then(onUpdated, onError);
-}
-
-var querying = browser.tabs.query({currentWindow:true});
-querying.then(updateFirstTab, onError);
- -

{{WebExtExamples}}

- -

Compatibilité du navigateur

- -

{{Compat("webextensions.api.tabs.update", 10)}}

- -

Note :

- -

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md new file mode 100644 index 0000000000..76f37e6a2f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/update/index.md @@ -0,0 +1,162 @@ +--- +title: tabs.update() +slug: Mozilla/Add-ons/WebExtensions/API/tabs/update +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - Update + - WebExtensions + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/update +--- +
{{AddonSidebar()}}
+ +

Parcourez l'onglet vers une nouvelle URL ou modifiez d'autres propriétés de l'onglet.

+ +

Pour utiliser cette fonction, transmettez l'ID de l'onglet à mettre à jour et un objet updateProperties contenant les propriétés que vous souhaitez mettre à jour. Les propriétés qui ne sont pas spécifiées dans  updateProperties ne sont pas modifiées.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var updating = browser.tabs.update(
+  tabId,              // optional integer
+  updateProperties    // object
+)
+
+ +

Paramètres

+ +
+
tabId{{optional_inline}}
+
integer. Par défaut à l'onglet sélectionné de la fenêtre en cours.
+
updateProperties
+

object. L'ensemble des propriétés à mettre à jour pour cet onglet. Pour en savoir plus sur ces propriétés, consultez la documentation  {{WebExtAPIRef("tabs.Tab")}}.

+
+
active{{optional_inline}}
+
boolean. Si l'onglet doit devenir actif. Ne modifie pas le focus de la fenêtre (voir {{WebExtAPIRef('windows.update')}}). Si true, les onglets surlignés non actifs cesseront d'être surlignés. Si false, ne fait rien.
+
autoDiscardable{{optional_inline}}
+
boolean. Si l'onglet doit être supprimé automatiquement par le navigateur lorsque les ressources sont faibles.
+
highlighted{{optional_inline}}
+

boolean. Ajoute ou supprime l'onglet de la sélection courante. Si true et que l'onglet n'est pas surligné, il deviendra actif par défaut.

+

Si vous voulez seulement mettre en surbrillance l'onglet sans l'activer, Firefox accepte le réglage highlighted à true et active à false. D'autres navigateurs peuvent activer l'onglet même dans ce cas.

+
+
loadReplace{{optional_inline}}
+
+

boolean. Si la nouvelle URL doit remplacer l'ancienne URL dans l'historique de navigation de l'onglet, accessible via le bouton "Retour".

+ +

Par exemple, supposons que l'utilisateur crée un nouvel onglet en utilisant Ctrl + T. Par défaut, dans Firefox, cela chargerait "about:newtab". Si votre extension met alors à jour cette page en utilisant {{WebExtAPIRef("tabs.update")}}, sans loadReplace, le bouton "retour" sera activé et ramènera l'utilisateur à "about:newtab". Si l'extension définit loadReplace, le bouton "retour" sera désactivé et ce sera comme si l'URL fournie par l'extension était la première page visitée dans cet onglet.

+ +

Notez cependant que l'URL d'origine apparaîtra toujours dans l'historique global du navigateur.

+
+
muted{{optional_inline}}
+
boolean. Si l'onglet doit être coupé.
+
openerTabId{{optional_inline}}
+
integer. L'ID de l'onglet qui a ouvert cet onglet. Si spécifié, l'onglet d'ouverture doit être dans la même fenêtre que cet onglet.
+
pinned{{optional_inline}}
+
boolean. Si l'onglet doit être épinglé.
+
selected {{deprecated_inline}} {{optional_inline}}
+
boolean. Si l'onglet doit être sélectionné. Cette propriété a été remplacée par active et highlighted.
+
successorTabId {{optional_inline}}
+
integer. L'identifiant de l'ID du successeur de l'onglet.
+
url{{optional_inline}}
+

string. Une URL pour naviguer dans l'onglet.

Pour des raisons de sécurité, dans Firefox, il se peut que ce ne soit pas une URL privilégiée. Le passage de l'une des URL suivantes échouera, avec {{WebExtAPIRef("runtime.lastError")}} étant défini sur un message d'erreur :

+
    +
  • chrome: URLs
    • +
  • javascript: URLs
    • +
  • data: URLs
    • +
  • file: URLs (c'est-à-dire, fichiers sur le système de fichiers, cependant, pour utiliser un fichier empaqueté à l'intérieur de l'extension, voir ci-dessous)
    • +
  • confidentiel : URLs (par exemle, about:config, about:addons, about:debugging, about:newtab). Les URL non privilégiées (par exemple, about:blank) sont autorisées.
    • +
+

Pour charger une page fournie avec votre extension, spécifiez une URL absolue à partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractère '/', l'URL est traitée comme une URL relative et différents navigateurs peuvent construire différentes URL absolues.

+
+
+
+ +

Valeur retournée

+ +

A Promise qui sera remplie avec un objet {{WebExtAPIRef('tabs.Tab')}} contenant des détails sur l'onglet mis à jour. L'objet {{WebExtAPIRef('tabs.Tab')}} ne contient pas d' url, title et favIconUrl sauf si la permission "tabs" a été demandée. Si l'onglet n'a pas pu être trouvé ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.

+ +

Exemples

+ +

Naviguez dans l'onglet actif de la fenêtre en cours pour https://developer.mozilla.org :

+ +
function onUpdated(tab) {
+  console.log(`Updated tab: ${tab.id}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var updating = browser.tabs.update({url: "https://developer.mozilla.org"});
+updating.then(onUpdated, onError);
+ +

Activez le premier onglet de la fenêtre actuelle et naviguez jusqu'à https://developer.mozilla.org:

+ +
function onUpdated(tab) {
+  console.log(`Updated tab: ${tab.id}`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function updateFirstTab(tabs) {
+  var updating = browser.tabs.update(tabs[0].id, {
+    active: true,
+    url: "https://developer.mozilla.org"
+  });
+  updating.then(onUpdated, onError);
+}
+
+var querying = browser.tabs.query({currentWindow:true});
+querying.then(updateFirstTab, onError);
+ +

{{WebExtExamples}}

+ +

Compatibilité du navigateur

+ +

{{Compat("webextensions.api.tabs.update", 10)}}

+ +

Note :

+ +

Cette API est basée sur l’API chrome.tabs de Chromium. Cette documentation est dérivée de tabs.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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.html deleted file mode 100644 index cfed6e3f85..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: tabs.WindowType -slug: Mozilla/Add-ons/WebExtensions/API/tabs/WindowType -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - WindowType - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/WindowType ---- -
{{AddonSidebar()}}
- -

Le type de fenêtre qui héberge cet onglet.

- -

Type

- -

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

- - - -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md new file mode 100644 index 0000000000..cfed6e3f85 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/windowtype/index.md @@ -0,0 +1,73 @@ +--- +title: tabs.WindowType +slug: Mozilla/Add-ons/WebExtensions/API/tabs/WindowType +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - WindowType + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/WindowType +--- +
{{AddonSidebar()}}
+ +

Le type de fenêtre qui héberge cet onglet.

+ +

Type

+ +

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

+ + + +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.html deleted file mode 100644 index 2d32640a5b..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: tabs.ZoomSettings -slug: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettings -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - ZoomSettings - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettings ---- -
{{AddonSidebar()}}
- -

Définit les paramètres de zoom pour un onglet : {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par défaut.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
defaultZoomFactor{{optional_inline}}
-
number. Le niveau de zoom par défaut pour l'onglet actuel. Notez que ceci n'est utilisé que dans {{WebExtAPIRef("tabs.getZoomSettings")}}.
-
mode{{optional_inline}}
-
{{WebExtAPIRef('tabs.ZoomSettingsMode')}}. Définit si les modifications de zoom sont gérées par le navigateur, par l'extension ou désactivées.
-
scope{{optional_inline}}
-
{{WebExtAPIRef('tabs.ZoomSettingsScope')}}. Définit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md new file mode 100644 index 0000000000..2d32640a5b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettings/index.md @@ -0,0 +1,75 @@ +--- +title: tabs.ZoomSettings +slug: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettings +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - ZoomSettings + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettings +--- +
{{AddonSidebar()}}
+ +

Définit les paramètres de zoom pour un onglet : {{WebExtAPIRef("tabs.ZoomSettingsMode", "mode")}}, {{WebExtAPIRef("tabs.ZoomSettingsScope", "scope")}}, et le facteur de zoom par défaut.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
defaultZoomFactor{{optional_inline}}
+
number. Le niveau de zoom par défaut pour l'onglet actuel. Notez que ceci n'est utilisé que dans {{WebExtAPIRef("tabs.getZoomSettings")}}.
+
mode{{optional_inline}}
+
{{WebExtAPIRef('tabs.ZoomSettingsMode')}}. Définit si les modifications de zoom sont gérées par le navigateur, par l'extension ou désactivées.
+
scope{{optional_inline}}
+
{{WebExtAPIRef('tabs.ZoomSettingsScope')}}. Définit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.html deleted file mode 100644 index e9122e79e3..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: tabs.ZoomSettingsMode -slug: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - ZoomSettingsMode - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode ---- -
{{AddonSidebar()}}
- -

Définit comment les modifications de zoom sont gérées. Les extensions peuvent transférer cette valeur dans {{WebExtAPIRef("tabs.setZoomSettings()")}} pour contrôler la façon dont le navigateur gère les tentatives de modification des paramètres de zoom pour un onglet. Par défaut à "automatique".

- -

Type

- -

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

- -
-
"automatic"
-
Les modifications de zoom sont gérées normalement par le navigateur.
-
"disabled"
-
Désactive tout zoom dans l'onglet. L'onglet revient au niveau de zoom par défaut, et toutes les modifications de zoom tentées seront ignorées.
-
"manual"
-
L'extension gère elle-même les changements de zoom, en écoutant l'événement {{WebExtAPIRef("tabs.onZoomChange")}} et en redimensionnant la page en conséquence. Ce mode ne prend pas en charge le zoom per-origin : il ignore la portée {{WebExtAPIRef("tabs.zoomSettings", "zoom setting")}} et utilise toujours la fonction per-tab.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md new file mode 100644 index 0000000000..e9122e79e3 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsmode/index.md @@ -0,0 +1,75 @@ +--- +title: tabs.ZoomSettingsMode +slug: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - ZoomSettingsMode + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsMode +--- +
{{AddonSidebar()}}
+ +

Définit comment les modifications de zoom sont gérées. Les extensions peuvent transférer cette valeur dans {{WebExtAPIRef("tabs.setZoomSettings()")}} pour contrôler la façon dont le navigateur gère les tentatives de modification des paramètres de zoom pour un onglet. Par défaut à "automatique".

+ +

Type

+ +

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

+ +
+
"automatic"
+
Les modifications de zoom sont gérées normalement par le navigateur.
+
"disabled"
+
Désactive tout zoom dans l'onglet. L'onglet revient au niveau de zoom par défaut, et toutes les modifications de zoom tentées seront ignorées.
+
"manual"
+
L'extension gère elle-même les changements de zoom, en écoutant l'événement {{WebExtAPIRef("tabs.onZoomChange")}} et en redimensionnant la page en conséquence. Ce mode ne prend pas en charge le zoom per-origin : il ignore la portée {{WebExtAPIRef("tabs.zoomSettings", "zoom setting")}} et utilise toujours la fonction per-tab.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.html b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.html deleted file mode 100644 index 19ea5f571a..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: tabs.ZoomSettingsScope -slug: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsScope -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - ZoomSettingsScope - - tabs -translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsScope ---- -
{{AddonSidebar()}}
- -

Définit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet. La valeur par défaut est à per-origin lorsque   {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique", et est toujours per-tab.

- -

Type

- -

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

- -
-
"per-origin"
-
Tous les autres onglets ayant la même origine que cet onglet auront les changements de zoom qui leur sont appliqués. Cette étendue n'est disponible que si  if {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique".
-
"per-tab"
-
Les changements de zoom ne prennent effet que dans cet onglet et les changements de zoom dans les autres onglets n'affectent pas le zoom de cet onglet. De plus, les changements de zoom per-tab ont réinitialisés lors de la navigation ; la navigation dans un onglet charge toujours les pages avec per-origin de zoom d'origine.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples}}

- -

Note :

- -

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.

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md new file mode 100644 index 0000000000..19ea5f571a --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/tabs/zoomsettingsscope/index.md @@ -0,0 +1,73 @@ +--- +title: tabs.ZoomSettingsScope +slug: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsScope +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - ZoomSettingsScope + - tabs +translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/ZoomSettingsScope +--- +
{{AddonSidebar()}}
+ +

Définit si les changements de zoom persisteront pour l'origine de la page ou ne prendront effet que dans cet onglet. La valeur par défaut est à per-origin lorsque   {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique", et est toujours per-tab.

+ +

Type

+ +

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

+ +
+
"per-origin"
+
Tous les autres onglets ayant la même origine que cet onglet auront les changements de zoom qui leur sont appliqués. Cette étendue n'est disponible que si  if {{WebExtAPIRef("tabs.zoomSettingsMode")}} est "automatique".
+
"per-tab"
+
Les changements de zoom ne prennent effet que dans cet onglet et les changements de zoom dans les autres onglets n'affectent pas le zoom de cet onglet. De plus, les changements de zoom per-tab ont réinitialisés lors de la navigation ; la navigation dans un onglet charge toujours les pages avec per-origin de zoom d'origine.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples}}

+ +

Note :

+ +

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.

+ +

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.

+
+ + -- cgit v1.2.3-54-g00ecf