1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
---
title: optional_permissions
slug: Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions
tags:
- Add-ons
- WebExtensions
- manifest.json
- optional_permissions
translation_of: Mozilla/Add-ons/WebExtensions/manifest.json/optional_permissions
---
<div>{{AddonSidebar}}</div>
<table class="standard-table">
<tbody>
<tr>
<th scope="row" style="width: 30%;">Type</th>
<td>Tableau</td>
</tr>
<tr>
<th scope="row">Obligatoire</th>
<td>Non</td>
</tr>
<tr>
<th scope="row">Exemple</th>
<td>
<pre class="brush: json">
"optional_permissions": [
"*://developer.mozilla.org/*",
"webRequest"
]</pre>
</td>
</tr>
</tbody>
</table>
<p>Utilisez la clé <code>optional_permissions</code> pour lister les permissions que vous souhaitez demander pour l'exécution, une fois que votre extension a été installée.</p>
<p>La clé de <code><a href="/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a></code> énumère les permissions dont votre extension a besoin si elle doit être installée. En revanche , <code>optional_permissions</code> liste les permissions dont votre extension n'a pas besoin au moment de l'installation, mais qu'il peut être nécessaire de demander pour l'exécution à un moment donné après son installation. Pour demander une permission, utilisez l'API {{webextapiref("permissions")}} . La demande de permission peut présenter probablement à l'utilisateur une boîte de dialogue lui demandant d'accorder la permission à votre extension.</p>
<p>Pour des conseils sur la conception de votre demande d'autorisations d'exécution, afin de maximiser la probabilité que les utilisateurs les accordent, consultez la section, voir <a href="/fr/docs/Mozilla/Add-ons/WebExtensions/demander_les_bonnes_permissions#Demander_les_permissions_à_éxécuter">Demander les permissions à éxécuter</a>.</p>
<p>La clé peut contenir deux types d'autorisations: les permissions d'hôte et les permissions d'API</p>
<h2 id="Permissions_dhôte">Permissions d'hôte</h2>
<p>Ce sont les mêmes que les permissions d'hôte que vous pouvez spécifier dans la clé <code><a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#Host_permissions">permissions</a></code>.</p>
<h2 id="Permissions_dAPI">Permissions d'API</h2>
<p>Vous pouvez inclure l'un des éléments suivants ici, mais pas dans tous les navigateurs : consultez la table de compatibilité pour obtenir des détails spécifiques au navigateur :</p>
<div class="threecolumns">
<ul>
<li><code>activeTab</code></li>
<li><code>background</code></li>
<li><code>bookmarks</code></li>
<li><code>browserSettings</code></li>
<li><code>clipboardRead</code></li>
<li><code>clipboardWrite</code></li>
<li><code>contentSettings</code></li>
<li><code>contextMenus</code></li>
<li><code>cookies</code></li>
<li><code>debugger</code></li>
<li><code>downloads</code></li>
<li><code>downloads.open</code></li>
<li><code>find</code></li>
<li><code>geolocation</code></li>
<li><code>history</code></li>
<li><code>idle</code></li>
<li><code>management</code></li>
<li><code>notifications</code></li>
<li><code>pageCapture</code></li>
<li><code>privacy</code></li>
<li><code>tabHide</code></li>
<li><code>tabs</code></li>
<li><code>topSites</code></li>
<li><code>webNavigation</code></li>
<li><code>webRequest</code></li>
<li><code>webRequestBlocking</code></li>
</ul>
</div>
<p>Notez qu'il s'agit d'un sous-ensemble des permissions API permises dans les <code><a href="/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions">permissions</a></code>.</p>
<p>Dans cet ensemble, les permissions suivantes sont accordées en silence, sans invite de l'utilisateur : <code>activeTab</code>, <code>cookies</code>, <code>idle</code>, <code>webRequest</code>, <code>webRequestBlocking</code>.</p>
<h2 id="Exemple">Exemple</h2>
<pre class="brush: json"> "optional_permissions": ["*://developer.mozilla.org/*"]</pre>
<p>Activez l'extension pour demander un accès privilégié aux pages sous developer.mozilla.org.</p>
<pre class="brush: json"> "optional_permissions": ["tabs"]</pre>
<p>Activez l'extension pour demander l'accès aux éléments privilégiés de l'API des onglets.</p>
<pre class="brush: json"> "optional_permissions": ["*://developer.mozilla.org/*", "tabs"]</pre>
<p>Activez l'extension pour demander les deux permissions ci-dessus.</p>
<h2 id="Comptabilité_du_navigateur">Comptabilité du navigateur</h2>
<p>{{Compat("webextensions.manifest.optional_permissions")}}</p>
|
