permissions

Host-Berechtigungen

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

Die zusätzlichen Privilegien umfassen:

• Zugriff auf XMLHttpRequest und fetch für diese Ursprünge ohne Cross-Origin-Beschränkungen (auch für Anfragen von Content-Skripten)
• die Möglichkeit, tab-spezifische Metadaten wie die url-, title- und favIconUrl-Eigenschaften von tabs.Tab-Objekten ohne die "tabs"-Berechtigung zu lesen
• die Fähigkeit, Inhaltsskripte und Stile programmgesteuert in Seiten einzufügen, die von diesen Ursprüngen geliefert werden
• 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, sofern auch die "cookies" API-Berechtigung enthalten ist
• Umgehung des Trackingschutzes für Erweiterungsseiten, bei denen ein Host als vollständige Domain oder mit Wildcards angegeben ist. Inhaltsskripte können den Trackingschutz jedoch nur bei Hosts umgehen, die mit einer vollständigen Domain angegeben sind.

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 abrufen, indem sie extension.getURL() aufruft:

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

API-Berechtigungen

API-Berechtigungen werden als Schlüsselwörter angegeben, wobei jedes Schlüsselwort eine WebExtension API benennt, 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 implizit erteilt, wenn der devtools_page Manifestschlü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 nur den Zugriff auf die API, mit den folgenden Ausnahmen:

• tabs gibt Ihnen Zugriff auf privilegierte Teile der tabs API ohne die Notwendigkeit für 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 von tabs.query() einfügen möchten. Der Rest der tabs API kann ohne Anforderung einer Berechtigung verwendet werden.
  • Ab Firefox 86 und Chrome 50 können übereinstimmende Host-Berechtigungen anstelle der "tabs"-Berechtigung verwendet werden.

• webRequestBlocking ermöglicht es Ihnen, das Argument "blocking" zu verwenden, sodass Sie Anfragen modifizieren und abbrechen können.

• downloads.open ermöglicht es Ihnen, die downloads.open() API zu nutzen.

• tabHide ermöglicht es Ihnen, die tabs.hide() API zu nutzen.

activeTab Berechtigung

Wenn eine Erweiterung über die Berechtigung "activeTab" verfügt, werden der Erweiterung, wenn ein Benutzer mit der Erweiterung interagiert, zusätzliche Privilegien nur für den aktiven Tab gewährt.

Diese Interaktionen sind als Benutzeraktionen bekannt und umfassen:

• Klicken auf die Symbolleistenschaltfläche oder Page Action der Erweiterung.
• Auswahl eines Kontextmenüeintrags der Erweiterung.
• Aktivierung einer Tastenkombination, die von der Erweiterung definiert wurde (ab Firefox 63).
• Klicken auf eine Schaltfläche auf einer mit der Erweiterung gebündelten Seite.
• Klicken auf einen Erweiterungsvorschlag in der Adressleiste (Omnibox) (ab Firefox 142).

Die zusätzlichen Privilegien sind:

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

Das Ziel dieser Berechtigung ist es, Erweiterungen zu ermöglichen, ein allgemeines Anwendungsfall zu erfüllen, ohne ihnen sehr mächtige Berechtigungen zu geben. Viele Erweiterungen möchten "etwas auf der aktuellen Seite tun, wenn der Benutzer es fordert".

Zum Beispiel wollen wir eine Erweiterung betrachten, die ein Skript auf der aktuellen Seite ausführen möchte, 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. Aber dies gibt der Erweiterung mehr Macht 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 gleichem Ursprung. Für das Ausführen von Skripten oder das Ändern von Stilen innerhalb von cross-origin Frames können zusätzliche Host-Berechtigungen erforderlich sein. Natürlich werden auch Einschränkungen und Begrenzungen in Bezug auf bestimmte Sites und URI-Schemata angewendet.

In der Regel 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 mit der rechten Maustaste auf einen Tab 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, den der Benutzer anklickt, auch wenn es sich nicht um den aktiven Tab handelt (ab Firefox 63, Firefox Bug 1446956).

Zugriff auf die Zwischenablage

Es gibt zwei Berechtigungen, die es der Erweiterung ermöglichen, mit der Zwischenablage zu interagieren:

clipboardWrite

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

clipboardRead

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

Details finden Sie unter Interact with the clipboard.

Unbegrenzter Speicher

Die Berechtigung unlimitedStorage:

• Ermöglicht Erweiterungen, alle Quoten zu übersteigen, die von der storage.local API auferlegt werden
• Ermöglicht es Erweiterungen in Firefox, eine "persistent" IndexedDB-Datenbank zu erstellen, ohne dass der Browser den Benutzer zur Genehmigung auffordert, wenn die Datenbank erstellt wird.

Beispiele

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

In Manifest V2 nur, fordere privilegierten Zugriff auf Seiten unter developer.mozilla.org.

  "permissions": ["tabs"]

Fordere Zugriff auf die privilegierten Teile der tabs API.

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

In Manifest V2 nur, fordere beide oben genannten Berechtigungen an.

Browser-Kompatibilität