Deklarieren von API-Berechtigungen in Erweiterungsmanifesten
Um die chrome.* meisten APIs verwenden zu können, muss ihre Erweiterung ihre Absicht in den permissions Feldern des Manifests deklarieren. Eine Erweiterung kann Berechtigungen mithilfe einer Berechtigungszeichenfolge aus der folgenden Tabelle deklarieren oder ein Muster verwenden, um ähnliche Zeichenfolgen abzugleichen. Berechtigungen helfen, Ihre Erweiterung einzuschränken, wenn sie durch Schadsoftware kompromittiert wird. Einige Berechtigungen werden Benutzern vor der Installation der Erweiterung oder bei Bedarf zur Laufzeit zur Zustimmung angezeigt. Dies sind Berechtigungswarnungen.
Wenn Eine API erfordert, dass Sie Berechtigungen im Manifest deklarieren, lesen Sie die Dokumentation für diese API, um die erforderlichen Berechtigungen zu verstehen. Auf der Seite Storage-API wird beispielsweise beschrieben, wie die storage Berechtigung deklariert wird.
Hier sehen Sie ein Beispiel für den Berechtigungsteil einer Manifestdatei:
"permissions": [
"tabs",
"bookmarks",
"storage"
],
"optional_permissions": [
"unlimitedStorage"
],
"host_permissions": [
"http://www.blogger.com/",
"http://*.google.com/"
],
In der folgenden Tabelle sind die derzeit verfügbaren Berechtigungszeichenfolgen für die Verwendung in Ihrem Manifest sowie die Beschreibungen aufgeführt.
| Berechtigungszeichenfolge | Details |
|---|---|
activeTab |
Fordert an, dass der Erweiterung Berechtigungen gemäß der activeTab Spezifikation erteilt werden. |
alarms |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.alarms API. |
background |
Bewirkt, dass Microsoft Edge früh gestartet und später heruntergefahren wird, sodass Erweiterungen möglicherweise eine längere Lebensdauer haben. Wenn eine installierte Erweiterung über die Berechtigung verfügt background , wird Microsoft Edge unsichtbar ausgeführt, sobald sich der Benutzer auf dem Computer des Benutzers anmeldet und bevor der Benutzer Microsoft Edge startet. Die background Berechtigung sorgt auch dafür, dass Microsoft Edge weiterhin ausgeführt wird, auch nachdem das letzte Fenster geschlossen wurde, bis der Benutzer Microsoft Edge explizit beendet. Hinweis: Deaktivierte Erweiterungen werden so behandelt, als wären sie nicht installiert. Sie sollten die background Berechtigung mit Hintergrundskripts verwenden. |
bookmarks |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.bookmarks API. |
browsingData |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.browsingData API. |
certificateProvider |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.certificateProvider API. |
clipboardRead |
Erforderlich, wenn die Erweiterung verwendet document.execCommand('paste'). |
clipboardWrite |
Gibt an, dass die Erweiterung oder document.execCommand('cut')verwendetdocument.execCommand('copy'). |
contentSettings |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.contentSettings API. |
contextMenus |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.contextMenus API. |
cookies |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.cookies API. |
debugger |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.debugger API. |
declarativeContent |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeContent API. |
declarativeNetRequest |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeNetRequest API. Ermöglicht es der Erweiterung, Anforderungen zu blockieren und zu aktualisieren, ohne Dass Hostberechtigungen erforderlich sind, erfordert jedoch Hostberechtigungen zum Umleiten von Anforderungen oder ändern von Headern. |
declarativeNetRequestWithHostAccess |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeNetRequest API. Erfordert immer Hostberechtigungen für die Anforderungs-URL und für den Initiator, um auf die Anforderung reagieren zu können. |
declarativeNetRequestFeedback |
Gewährt der Erweiterung Zugriff auf Ereignisse und Methoden innerhalb der chrome.declarativeNetRequest API, die Informationen zu übereinstimmenden deklarativen Regeln zurückgibt. |
declarativeWebRequest |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.declarativeWebRequest API. |
desktopCapture |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.desktopCapture API. |
documentScan |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.documentScan API. |
downloads |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.downloads API. |
enterprise.deviceAttributes |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.deviceAttributes API. |
enterprise.hardwarePlatform |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.hardwarePlatform API. |
enterprise.networkingAttributes |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.networkingAttributes API. |
enterprise.platformKeys |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.enterprise.platformKeys API. |
experimental |
Erforderlich, wenn die Erweiterung eine API chrome.experimental.* verwendet. |
fileBrowserHandler |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.fileBrowserHandler API. |
fileSystemProvider |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.fileSystemProvider API. |
fontSettings |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.fontSettings API. |
geolocation |
Ermöglicht der Erweiterung, die Geolocation-API zu verwenden, ohne den Benutzer zur Berechtigung aufzufordern. |
history |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.history API. |
identity |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.identity API. |
idle |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.idle API. |
loginState |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.loginState API. |
management |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.management API. |
nativeMessaging |
Gewährt Ihrer Erweiterung Zugriff auf die native Messaging-API. |
notifications |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.notifications API. |
pageCapture |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.pageCapture API. |
platformKeys |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.platformKeys API. |
power |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.power API. |
printerProvider |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.printerProvider API. |
printing |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.printing API. |
printingMetrics |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.printingMetrics API. |
privacy |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.privacy API. |
processes |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.processes API. |
proxy |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.proxy API. |
scripting |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.scripting API. |
search |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.search API. |
sessions |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.sessions API. |
sidePanel |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.sidePanel API. Weitere Informationen finden Sie unter Erweiterungen in der Microsoft Edge-Randleiste. |
signedInDevices |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.signedInDevices API. |
storage |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.storage API. |
system.cpu |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.system.cpu API. |
system.display |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.system.display API. |
system.memory |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.system.memory API. |
system.storage |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.system.storage API. |
tabCapture |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.tabCapture API. |
tabGroups |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.tabGroups API. |
tabs |
Gewährt Ihrer Erweiterung Zugriff auf privilegierte Felder der Tab-Objekte , die von mehreren APIs verwendet werden können, einschließlich chrome.tabs und chrome.windows. In vielen Fällen muss Ihre Erweiterung die Berechtigung nicht deklarieren tabs , um diese APIs verwenden zu können. |
topSites |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.topSites API. |
tts |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.tts API. |
ttsEngine |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.ttsEngine API. |
unlimitedStorage |
Stellt ein unbegrenztes Kontingent für die Speicherung clientseitiger Daten bereit, z. B. Datenbanken und lokale Speicherdateien. Ohne diese Berechtigung ist die Erweiterung auf 5 MB lokalen Speicher beschränkt. Diese Berechtigung gilt nur für Web-SQL-Datenbank und Anwendungscache (siehe Problem 58985: Unbegrenzte Speicherberechtigung sollte für lokalen Speicher gelten). Diese Berechtigung funktioniert derzeit nicht mit Platzhalterunterdomänen wie http://*.contoso.com. |
vpnProvider |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.vpnProvider API. |
wallpaper |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.wallpaper API. |
webNavigation |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.webNavigation API. |
webRequest |
Gewährt Ihrer Erweiterung Zugriff auf die chrome.webRequest API. |
webRequestBlocking |
Erforderlich, wenn die Erweiterung die chrome.webRequest API verwendet, um Anforderungen zu blockieren. |
Hinweis
Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die von Google erstellt und geteilt und gemäß den in der Creative Commons Attribution 4.0 International License beschriebenen Bedingungen verwendet werden. Die ursprüngliche Seite finden Sie hier.
Dieses Werk ist unter einer Creative Commons Attribution 4.0 International License lizenziert.