permissions

Host-Berechtigungen

Host-Berechtigungen werden als Match Patterns angegeben, und jedes Muster identifiziert eine Gruppe von URLs, für die die Erweiterung zusätzliche Privilegien anfordert. Zum Beispiel könnte eine Host-Berechtigung "*://developer.mozilla.org/*" lauten.

Die zusätzlichen Privilegien umfassen:

• XMLHttpRequest und fetch Zugriff auf diese Ursprünge ohne Cross-Origin-Beschränkungen.

  Hinweis: Für Manifest V2-Erweiterungen nur in Firefox beinhalten diese Zugriffe Anfragen von Content-Skripten.

• die Fähigkeit, tab-spezifische Metadaten ohne die "tabs"-Berechtigung zu lesen, wie die Eigenschaften url, title und favIconUrl von tabs.Tab Objekten
• die Fähigkeit, Content-Skripte und Stile programmatisch in Seiten von diesen Ursprüngen einzufügen.
• die Fähigkeit, Ereignisse von der webRequest API für diese Hosts zu empfangen
• die Fähigkeit, auf Cookies für diesen Host mit der cookies API zuzugreifen, solange auch die Berechtigung "cookies" enthalten ist.
• Umgehung des Tracking-Schutzes für Seiten der Erweiterung, bei denen ein Host als vollständige Domäne oder mit Platzhaltern angegeben ist. Content-Skripte können jedoch nur den Tracking-Schutz für Hosts umgehen, die mit einer vollständigen Domäne angegeben sind.

In Firefox erhalten Erweiterungen ab Version 56 automatisch Host-Berechtigungen für ihren eigenen Ursprung, der folgende Form hat:

moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/

wobei 60a20a9b-1ad4-af49-9b6c-c64c98c37920 die interne ID der Erweiterung ist. Die Erweiterung kann diese URL programmatisch durch Aufruf von extension.getURL() erhalten:

browser.extension.getURL("");
// moz-extension://60a20a9b-1ad4-af49-9b6c-c64c98c37920/

API-Berechtigungen

API-Berechtigungen werden als Schlüsselwörter angegeben, und jedes Schlüsselwort benennt eine WebExtension API, die die Erweiterung verwenden möchte.

Diese Berechtigungen sind ab Manifest V2 und höher verfügbar, sofern nicht anders angegeben:

• activeTab
• alarms
• background
• bookmarks
• browserSettings
• browsingData
• captivePortal
• clipboardRead
• clipboardWrite
• contentSettings
• contextMenus
• contextualIdentities
• cookies
• debugger
• declarativeNetRequest
• declarativeNetRequestFeedback
• declarativeNetRequestWithHostAccess
• devtools (Diese Berechtigung wird implizit gewährt, wenn der Manifest-Schlüssel devtools_page vorhanden ist.)
• dns
• downloads
• downloads.open
• find
• geolocation
• history
• identity
• idle
• management
• menus
• menus.overrideContext
• nativeMessaging
• notifications
• pageCapture
• pkcs11
• privacy
• proxy
• scripting
• search
• sessions
• storage
• tabGroups
• tabHide
• tabs
• theme
• topSites
• unlimitedStorage
• 'userScripts' (siehe userScripts-Berechtigung)
• webNavigation
• webRequest
• webRequestAuthProvider (Manifest V3 und höher)
• webRequestBlocking
• webRequestFilterResponse
• webRequestFilterResponse.serviceWorkerScript

In den meisten Fällen gewährt die Berechtigung einfach Zugriff auf die API, mit folgenden Ausnahmen:

• tabs gibt Ihnen Zugriff auf privilegierte Teile der tabs API ohne die Notwendigkeit von Host-Berechtigungen: Tab.url, Tab.title und Tab.faviconUrl.

  • In Firefox 85 und früher benötigen Sie auch tabs, wenn Sie url im queryInfo Parameter zu tabs.query() einbeziehen möchten. Der Rest der tabs API kann ohne Anforderung einer Berechtigung verwendet werden.
  • Ab Firefox 86 und Chrome 50 können passende Host-Berechtigungen anstelle der "tabs"-Berechtigung verwendet werden.

• webRequestBlocking ermöglicht Ihnen die Verwendung des "blocking" Arguments, sodass Sie Anfragen modifizieren und stornieren können.

• downloads.open ermöglicht Ihnen die Nutzung der downloads.open() API.

• tabHide ermöglicht Ihnen die Nutzung der tabs.hide() API.

ActiveTab-Berechtigung

Wenn eine Erweiterung die Berechtigung "activeTab" hat, wird der Erweiterung, sobald ein Benutzer mit der Erweiterung interagiert, nur für den aktiven Tab zusätzliche Privilegien gewährt.

Diese Interaktionen sind als Benutzeraktionen bekannt und umfassen den Benutzer:

• Klick auf die Toolbar-Schaltfläche oder Seitenaktion der Erweiterung.
• Auswahl eines Kontextmenüeintrags der Erweiterung.
• Aktivieren einer von der Erweiterung definierten Tastenkombination (ab Firefox 63).
• Klick auf eine Schaltfläche auf einer Seite, die mit der Erweiterung gebündelt ist.
• Klick auf einen Erweiterungsvorschlag in der Adressleiste (Omnibox) (ab Firefox 142).

Die zusätzlichen Privilegien sind:

• Die Fähigkeit, JavaScript oder CSS programmatisch in den Tab einzufügen (siehe Laden von Content-Skripten).
• Zugriff auf die privilegierten Teile der Tabs API für den aktuellen Tab: Tab.url, Tab.title und Tab.faviconUrl.

Die Absicht dieser Berechtigung ist es, Erweiterungen zu ermöglichen, einen häufigen Anwendungsfall zu erfüllen, ohne ihnen sehr mächtige Berechtigungen geben zu müssen. Viele Erweiterungen möchten "etwas mit der aktuellen Seite tun, wenn der Benutzer es verlangt".

Ein Beispiel: Eine Erweiterung möchte ein Skript in die aktuelle Seite ausführen, wenn der Benutzer auf eine Browseraktion klickt. Wenn die activeTab-Berechtigung nicht existieren würde, müsste die Erweiterung die Host-Berechtigung <all_urls> anfordern. Das würde der Erweiterung jedoch mehr Macht geben als nötig: sie könnte nun Skripte in jedem Tab, jederzeit ausführen, anstatt nur im aktiven Tab und nur als Reaktion auf eine Benutzeraktion.

Die activeTab-Berechtigung ermöglicht Skripting-Zugriff auf die oberste Seite des Tabs und Frames mit dem gleichen Ursprung. Das Ausführen von Skripten oder Modifizieren von Stilen in Cross-Origin Frames kann zusätzliche Host-Berechtigungen erfordern. Natürlich werden Einschränkungen und Begrenzungen, die für bestimmte Sites und URI-Schemata gelten, ebenfalls angewendet.

Normalerweise ist der Tab, dem activeTab gewährt wird, der aktive Tab, mit einer Ausnahme. Eine Erweiterung kann mit der menus API ein Menüelement erstellen, das angezeigt wird, wenn der Benutzer im Tabkontext klickt. Das heißt, ein Menü auf einem Element im Tabstrip, das es dem Benutzer ermöglicht, von einem Tab zu einem anderen zu wechseln. Wenn der Benutzer auf dieses Menü klickt, wird die activeTab-Berechtigung für den Tab gewährt, auf den der Benutzer geklickt hat, auch wenn es nicht der aktive Tab ist (ab Firefox 63, Firefox Bug 1446956).

Zwischenablagezugriff

Zwei Berechtigungen ermöglichen einer Erweiterung die Interaktion mit der Zwischenablage:

clipboardWrite

Schreiben in die Zwischenablage mit Clipboard.write(), Clipboard.writeText(), document.execCommand("copy") oder document.execCommand("cut").

clipboardRead

Lesen aus der Zwischenablage mit Clipboard.read(), Clipboard.readText() oder document.execCommand("paste").

Siehe Interaktion mit der Zwischenablage für weitere Details.

Unbegrenzte Speicherung

Die unlimitedStorage-Berechtigung:

• Ermöglicht Erweiterungen, jedes von der storage.local API auferlegte Kontingent zu überschreiten.
• Ermöglicht Erweiterungen in Firefox, ohne dass der Browser den Benutzer um Erlaubnis fragt, eine "persistente" IndexedDB-Datenbank zu erstellen, sobald die Datenbank erstellt wird.

Beispiele

 "permissions": ["*://developer.mozilla.org/*"]

Nur in Manifest V2: Privilegierten Zugriff auf Seiten unter developer.mozilla.org anfordern.

  "permissions": ["tabs"]

Zugriff auf die privilegierten Teile der tabs API anfordern.

  "permissions": ["*://developer.mozilla.org/*", "tabs"]

Nur in Manifest V2: Beide oben genannten Berechtigungen anfordern.

Browser-Kompatibilität