permissions

Host-Berechtigungen

Host-Berechtigungen werden als Übereinstimmungsmuster angegeben, und jedes Muster kennzeichnet eine Gruppe von URLs, für die die Erweiterung zusätzliche Privilegien anfordert. Beispielsweise könnte eine Host-Berechtigung "*://newreal1.mobosoft.fun/*" lauten.

Die zusätzlichen Privilegien umfassen:

• XMLHttpRequest und fetch-Zugriff auf diese Ursprünge ohne Cross-Origin-Beschränkungen (auch für Anfragen, die von Inhalts-Skripten gesendet werden)
• die Möglichkeit, tab-spezifische Metadaten ohne die "tabs"-Berechtigung zu lesen, wie z.B. die url, title und favIconUrl Eigenschaften von tabs.Tab Objekten
• die Möglichkeit, Inhalts-Skripte und Stile programmatisch in Seiten einzuspeisen, die von diesen Ursprüngen bereitgestellt werden.
• die Fähigkeit, Ereignisse von 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.
• Umgehung des Tracking-Schutzes für Erweiterungsseiten, bei denen ein Host als vollständige Domäne oder mit Wildcards angegeben ist. Inhalts-Skripte können jedoch den Tracking-Schutz nur 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 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, 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 implizit erteilt, 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 den 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() aufnehmen möchten. Der Rest der tabs API kann ohne Anforderung einer Berechtigung verwendet werden.
  • Ab Firefox 86 und Chrome 50 können auch entsprechende Host-Berechtigungen anstelle der "tabs"-Berechtigung verwendet werden.

• webRequestBlocking erlaubt Ihnen die Verwendung des "blocking" Arguments, sodass Sie Anfragen ändern und abbrechen können.

• downloads.open erlaubt Ihnen die Verwendung der downloads.open() API.

• tabHide erlaubt Ihnen die Verwendung der tabs.hide() API.

activeTab Berechtigung

Diese Berechtigung wird als "activeTab" angegeben. Wenn eine Erweiterung die activeTab-Berechtigung hat, erhält die Erweiterung, wenn der Benutzer mit ihr interagiert, zusätzliche Privilegien nur für den aktiven Tab.

"Benutzerinteraktion" umfasst:

• Der Benutzer klickt auf die browser action oder Seitenaktion der Erweiterung.
• Der Benutzer wählt dessen Kontextmenüpunkt aus.
• Der Benutzer aktiviert eine von der Erweiterung definierte Tastenkombination.

Die zusätzlichen Privilegien sind:

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

Der Zweck dieser Berechtigung besteht darin, es Erweiterungen zu ermöglichen, einen häufigen 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 wünscht".

Betrachten Sie zum Beispiel eine Erweiterung, 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 das gibt der Erweiterung mehr Macht, als sie benötigt: Sie könnte jetzt Skripte in jedem Tab, beliebig oft, nicht nur im aktiven Tab und nur als Reaktion auf eine Benutzeraktion, ausführen.

Die activeTab-Berechtigung ermöglicht Skriptzugriff auf die Seite des obersten Tabs und gleichartige Ursprungsrahmen. Das Ausführen von Skripten oder das Ändern von Stilen auf Grundlage von Cross-Origin-Rahmen kann zusätzliche Host-Berechtigungen erfordern. Natürlich werden auch Einschränkungen und Beschränkungen, die für bestimmte Sites und URI-Schemata gelten, berücksichtigt.

Normalerweise ist der Tab, dem activeTab gewährt wird, einfach der aktuell aktive Tab, außer in einem Fall. Die menus-API ermöglicht es einer Erweiterung, einen Menüpunkt zu erstellen, der angezeigt wird, wenn der Benutzer bei einem Tab (d.h. auf das Element im Tabstreifen, das den Benutzer ermöglicht, von einem Tab zum anderen zu wechseln) einen Kontextklick ausführt.

Wenn der Benutzer auf ein solches Element klickt, wird die activeTab-Berechtigung für den angeklickten Tab gewährt, auch wenn es nicht der aktuell aktive Tab ist (ab Firefox 63, Firefox Bug 1446956).

Zwischenablagenzugriff

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

clipboardWrite

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

clipboardRead

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

Weitere Details finden Sie unter Mit der Zwischenablage interagieren.

Unbegrenzter Speicher

Die unlimitedStorage-Berechtigung:

• ermöglicht es Erweiterungen, jede von der storage.local API auferlegte Quota zu überschreiten.
• ermöglicht in Firefox Erweiterungen das Erstellen einer "persistente" IndexedDB-Datenbank, ohne dass der Browser den Benutzer um Erlaubnis fragt, wenn die Datenbank erstellt wird.

Beispiele

 "permissions": ["*://newreal1.mobosoft.fun/*"]

In Manifest V2 nur, privilegierten Zugriff auf Seiten unter newreal1.mobosoft.fun anfordern.

  "permissions": ["tabs"]

Zugriff auf die privilegierten Teile der tabs API anfordern.

  "permissions": ["*://newreal1.mobosoft.fun/*", "tabs"]

In Manifest V2 nur, beide obigen Berechtigungen anfordern.

Browser-Kompatibilität