diff options
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.md | 78 |
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 => { + 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> |