permissions

Host-Berechtigungen

Host-Berechtigungen werden als Match-Muster 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/*" sein.

Die zusätzlichen Privilegien umfassen:

• XMLHttpRequest- und fetch-Zugriff auf diese Ursprünge ohne Cross-Origin-Beschränkungen (auch für Anfragen, die von Content-Skripten gemacht werden)
• die Möglichkeit, tab-spezifische Metadaten ohne die "tabs"-Berechtigung zu lesen, wie die url, title und favIconUrl-Eigenschaften von tabs.Tab-Objekten
• die Möglichkeit, Content-Scripts zu injizieren und Styles programmatisch in Seiten einzufügen, die von diesen Ursprüngen stammen.
• die Möglichkeit, Ereignisse der webRequest-API für diese Hosts zu empfangen
• die Möglichkeit, auf Cookies für diesen Host mit der cookies-API zuzugreifen, sofern die "cookies"-API-Berechtigung ebenfalls enthalten ist.
• das Umgehen des Tracking-Schutzes für Erweiterungsseiten, bei denen ein Host als vollständige Domain oder mit Wildcards angegeben wird. Content-Scripts können jedoch den Tracking-Schutz nur für Hosts umgehen, die mit einer vollständigen Domain angegeben werden.

In Firefox erhalten Erweiterungen ab Version 56 automatisch Host-Berechtigungen für ihren eigenen Ursprung, der die 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 in 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 automatisch erteilt, wenn der devtools_page-Manifest-Schlüssel 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 permission)
• 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 den 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 auch passende Host-Berechtigungen anstelle der "tabs"-Berechtigung verwendet werden.

• webRequestBlocking ermöglicht Ihnen die Verwendung des "blocking"-Arguments, sodass Sie Anfragen modifizieren und abbrechen 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 "activeTab"-Berechtigung hat, erhält sie, wenn ein Benutzer mit der Erweiterung interagiert, zusätzliche Privilegien nur für den aktiven Tab.

Diese Interaktionen werden als Benutzeraktionen bezeichnet und umfassen den Benutzer:

• Klicken auf den Toolbar-Button oder die Seitenschaltfläche der Erweiterung.
• Auswählen eines Kontextmenüpunkts der Erweiterung.
• Aktivieren einer von der Erweiterung definierten Tastenkombination (ab Firefox 63).
• Klicken auf eine Schaltfläche auf einer Seite, die mit der Erweiterung gebündelt ist.
• Klicken auf einen Erweiterungsvorschlag in der Adressleiste (omnibox) (ab Firefox 142).

Die zusätzlichen Privilegien sind:

• Die Möglichkeit, JavaScript oder CSS programmgesteuert in den Tab einzufügen (siehe Loading content scripts).
• 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 leistungsstarke Berechtigungen geben zu müssen. Viele Erweiterungen möchten "etwas auf der aktuellen Seite tun, wenn der Benutzer es verlangt".

Zum Beispiel, betrachten Sie eine Erweiterung, die ein Skript auf der aktuellen Seite ausführen möchte, wenn der Benutzer auf eine Aktion im Browser klickt. Wenn die activeTab-Berechtigung nicht existierte, müsste die Erweiterung die Host-Berechtigung <all_urls> anfordern. Aber dies gibt der Erweiterung mehr Macht, als sie braucht: Sie könnte jetzt Skripte in jedem Tab jederzeit ausführen, anstatt nur im aktiven Tab und nur als Reaktion auf eine Benutzeraktion.

Die activeTab-Berechtigung ermöglicht es, auf die Seite des obersten Tabs und Frames mit demselben Ursprung zuzugreifen. Das Ausführen von Skripten oder das Modifizieren von Stilen innerhalb von Cross-Origin-Frames kann zusätzliche Host-Berechtigungen erfordern. Selbstverständlich gelten auch Einschränkungen und Beschränkungen in Bezug auf bestimmte Websites und URI-Schemata.

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

Zwischenablagezugriff

Es gibt zwei Berechtigungen, die der Erweiterung den Zugriff auf die Zwischenablage ermöglichen:

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")

Weitere Details finden Sie unter Interact with the clipboard.

Unbegrenzter Speicher

Die unlimitedStorage-Berechtigung:

• Ermöglicht es Erweiterungen, ein beliebiges durch die storage.local API festgelegtes Kontingent zu überschreiten.
• Ermöglicht es in Firefox Erweiterungen, ohne Aufforderung des Browsers zum Zeitpunkt der Datenbankerstellung eine "persistent" IndexedDB-Datenbank zu erstellen.

Beispiele

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

Nur in Manifest V2, um privilegierten Zugriff auf Seiten unter developer.mozilla.org zu beantragen.

  "permissions": ["tabs"]

Zugriff auf die privilegierten Teile der tabs API beantragen.

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

Nur in Manifest V2, um beide obigen Berechtigungen zu beantragen.

Browser-Kompatibilität