aboutsummaryrefslogtreecommitdiff
path: root/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md')
-rw-r--r--files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md78
1 files changed, 78 insertions, 0 deletions
diff --git a/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md
new file mode 100644
index 0000000000..851dc1e386
--- /dev/null
+++ b/files/fr/mozilla/add-ons/webextensions/api/browseraction/isenabled/index.md
@@ -0,0 +1,78 @@
+---
+title: browserAction.isEnabled()
+slug: Mozilla/Add-ons/WebExtensions/API/browserAction/isEnabled
+tags:
+ - API
+ - Add-ons
+ - Extensions
+ - Method
+ - Reference
+ - WebExtensions
+ - browserAction
+ - isEnabled
+translation_of: Mozilla/Add-ons/WebExtensions/API/browserAction/isEnabled
+---
+<div>{{AddonSidebar()}}</div>
+
+<p>Renvoie <code>true</code> si l'action du navigateur est activée.</p>
+
+<p>C'est une fonction asynchrone qui renvoie une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code>.</p>
+
+<h2 id="Syntaxe">Syntaxe</h2>
+
+<pre class="brush: js">let gettingIsEnabled = browser.browserAction.isEnabled(
+ details // object
+)
+</pre>
+
+<h3 id="Paramètres">Paramètres</h3>
+
+<dl>
+ <dt><code>details</code></dt>
+ <dd><p><code>object</code>. Un objet contenant éventuellement le <code>tabId</code> ou <code>windowId</code> à vérifier.</p>
+ <dl>
+ <dt><code>tabId</code> {{optional_inline}}</dt>
+ <dd><code>integer</code>. ID d'un onglet à vérifier</dd>
+ <dt><code>windowId</code> {{optional_inline}}</dt>
+ <dd><code>integer</code>. ID d'une fenêtre à vérifier.</dd>
+ </dl>
+ </dd>
+</dl>
+
+
+
+<ul>
+ <li>Si windowId et tabId sont tous les deux fournis, la fonction échoue.</li>
+ <li>Si windowId et tabId sont tous les deux omis, l'état global activé/désactivé est renvoyé.</li>
+</ul>
+
+<h3 id="Valeur_retournée">Valeur retournée</h3>
+
+<p>Une <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise">Promise</a></code> qui sera remplie avec <code>true</code> si l'action du navigateur de l'extension est activée, et <code>false</code> dans le cas contraire.</p>
+
+<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>
+
+<p>{{Compat("webextensions.api.browserAction.isEnabled",2)}}</p>
+
+<h2 id="Exemples">Exemples</h2>
+
+<p>Vérifiez l'état global :</p>
+
+<pre class="brush: js">browser.browserAction.isEnabled({}).then(result =&gt; {
+  console.log(result);
+});</pre>
+
+<p>Vérifiez l'état de l'onglet actuellement actif :</p>
+
+<pre class="brush: js">async function enabledInActiveTab() {
+  let tabs = await browser.tabs.query({
+ currentWindow:true,
+ active: true
+ });
+  let enabled = await browser.browserAction.isEnabled({
+ tabId: tabs[0].id
+ });
+  console.log(enabled);
+}</pre>
+
+<p>{{WebExtExamples}}</p>