optional_permissions
| Typ | Array |
|---|---|
| Erforderlich | Nein |
| Manifest-Version | 2 oder höher |
| Beispiel |
json |
Verwenden Sie den Schlüssel optional_permissions, um Berechtigungen aufzulisten, die Sie zur Laufzeit anfordern möchten, nachdem Ihre Erweiterung installiert wurde.
Der Schlüssel permissions listet Berechtigungen auf, die Ihre Erweiterung benötigt, bevor sie installiert werden kann. Im Gegensatz dazu listet optional_permissions Berechtigungen auf, die Ihre Erweiterung nicht zum Installationszeitpunkt benötigt, aber nach der Installation anfordern kann. Um eine Berechtigung anzufordern, verwenden Sie die API permissions.request(). Das Anfordern einer Berechtigung zeigt dem Benutzer einen Dialog an, der ihn bittet, die Berechtigung für Ihre Erweiterung zu erteilen, es sei denn, alle angeforderten Berechtigungen werden stillschweigend gewährt.
Für Ratschläge, wie Sie Ihre Anfrage für Laufzeitberechtigungen gestalten können, um die Wahrscheinlichkeit zu maximieren, dass Benutzer diese erteilen, lesen Sie Berechtigungen zur Laufzeit anfordern.
Hinweis:
Benutzer können optionale Berechtigungen über den Firefox-Add-ons-Manager verwalten. Erweiterungen, die optionale Berechtigungen verwenden, können die vom Benutzer gewährten Berechtigungen mit permissions.getAll() überprüfen und auf permissions.onAdded und permissions.onRemoved hören, um zu erfahren, wann ein Benutzer Berechtigungen erteilt oder widerruft.
Der Schlüssel kann Hostberechtigungen und API-Berechtigungen enthalten.
Hostberechtigungen
Dies sind dieselben Hostberechtigungen, die Sie im Schlüssel permissions angeben können.
Hinweis:
Bei der Verwendung von Manifest V3 oder höher sollten optionale Hostberechtigungen mit dem Manifest-Schlüssel optional_host_permissions angegeben werden. Firefox hat optional_host_permissions in Version 128 eingeführt, siehe Bug 1766026, und erlaubt die weitere Nutzung von optional_permissions zur Angabe optionaler Hosts. Die Verwendung von optional_host_permissions wird jedoch empfohlen.
API-Berechtigungen
Die optionalen API-Berechtigungen sind:
activeTabbackgroundbookmarksbrowserSettingsbrowsingDataclipboardReadclipboardWritecontentSettingscontextMenuscookiesdebuggerdeclarativeNetRequestdeclarativeNetRequestFeedbackdeclarativeNetRequestWithHostAccessdevtoolsdownloadsdownloads.openfindgeolocationhistoryidlemanagementnativeMessagingnotificationspageCapturepkcs11privacyproxyscriptingsearchsessionstabHidetabGroupstabstopSitesuserScripts(optional-only)webNavigationwebRequestwebRequestBlockingwebRequestFilterResponsewebRequestFilterResponse.serviceWorkerScript
Überprüfen Sie die Kompatibilitätstabelle für detailspezifische Unterstützung.
Diese optionalen Berechtigungen werden stillschweigend erteilt, ohne eine Benutzerabfrage:
activeTabcookiesidletabGroupswebRequestwebRequestBlockingwebRequestFilterResponsewebRequestFilterResponse.serviceWorkerScript
Nur-optional-Berechtigungen
Optionale Berechtigungen stehen im Allgemeinen für den Einsatz im Schlüssel permissions zur Verfügung, sodass sie zur Installationszeit angefordert werden können. Einige Browser unterstützen jedoch das Konzept von nur-optional-Berechtigungen, Berechtigungen, die nur zur Laufzeit angefordert werden können. In Firefox können Benutzer z. B. nur-optional-Berechtigungen von der Optionen-Seite der Erweiterung oder mit permissions.request() erteilen. Nur-optional-Berechtigungen müssen einzeln und allein über die API permissions.request() angefordert werden.
Die nur-optional API-Berechtigungen sind:
userScripts(siehe userScripts-Berechtigung)
Beispiele
"optional_permissions": ["*://developer.mozilla.org/*"]
Nur in Manifest V2 ermöglicht es der Erweiterung, privilegierten Zugriff auf Seiten unter developer.mozilla.org anzufordern.
"optional_permissions": ["tabs"]
Ermöglicht der Erweiterung, den Zugriff auf die privilegierten Teile der tabs API anzufordern.
"optional_permissions": ["*://developer.mozilla.org/*", "tabs"]
Nur in Manifest V2 ermöglicht es der Erweiterung, beide oben genannten Berechtigungen anzufordern.