permissions

Host-Berechtigungen

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

Die zusätzlichen Berechtigungen umfassen:

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

  Hinweis: Für Manifest V2-Erweiterungen in Firefox umfasst dies Anfragen, die von Inhalts-Skripten gemacht 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, Inhaltsskripte und Styles programmatisch in Seiten von diesen Ursprüngen einzufügen.
• Die Möglichkeit, 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, solange die "cookies" API-Berechtigung vorhanden ist.
• Umgehen des Tracking-Schutzes für Erweiterungsseiten, bei denen ein Host als vollständige Domain oder mit Platzhaltern angegeben ist. Inhaltsskripte können jedoch nur den Tracking-Schutz für Hosts umgehen, die mit einer vollständigen Domain angegeben sind.
• Die Möglichkeit, WebAuthn-Zugangsdaten zu erstellen und abzurufen. Weitere Details finden Sie unter Verwendung der Web Authn API in Web-Erweiterungen.

API-Berechtigungen

Sie geben API-Berechtigungen als Schlüsselwörter an, 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, es sei denn, es ist anders vermerkt:

• 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 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 Berechtigung)
• 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 diesen 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 außerdem tabs, wenn Sie url im queryInfo Parameter zu tabs.query() einschließen möchten. Die Erweiterung kann den Rest der tabs API ohne Anforderung einer Berechtigung verwenden.
  • Ab Firefox 86 und Chrome 50 können auch übereinstimmende Host-Berechtigungen anstelle der "tabs" Berechtigung verwendet werden.

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

• downloads.open erlaubt die Nutzung der downloads.open() API.

• tabHide erlaubt die Nutzung der tabs.hide() API.

activeTab Berechtigung

Wenn eine Erweiterung die Berechtigung "activeTab" hat, erhält sie bei Interaktion des Benutzers mit der Erweiterung zusätzliche Berechtigungen nur für den aktiven Tab.

Diese Interaktionen sind bekannt als Benutzeraktionen und umfassen den Benutzer:

• Klick auf den Symbolleistenschaltfläche oder Seitenaktionsschaltfläche der Erweiterung.
• Auswahl eines Kontextmenüeintrags der Erweiterung.
• Aktivierung einer Tastenkombination, die von der Erweiterung definiert wurde (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 Berechtigungen sind:

• Die Möglichkeit, JavaScript oder CSS programmatisch 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.

Die Absicht dieser Berechtigung ist es, Erweiterungen zu ermöglichen, einen häufigen Anwendungsfall zu erfüllen, ohne ihnen übermäßig mächtige Berechtigungen zu gewähren. Viele Erweiterungen möchten "etwas auf der aktuellen Seite tun, wenn der Benutzer es fordert".

Ein Beispiel: Stellen Sie sich eine Erweiterung vor, die ein Skript auf der aktuellen Seite ausführen möchte, wenn der Benutzer auf eine Browser-Aktion 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 kann nun Skripte in jedem Tab beliebig ausführen, anstatt nur im aktiven Tab und nur als Antwort auf eine Benutzeraktion.

Die activeTab-Berechtigung ermöglicht Skripting-Zugriff auf die Seite des obersten Tabs und Frames mit demselben Ursprung. Das Ausführen von Skripten oder das Modifizieren von Styles innerhalb von cross-origin Frames kann zusätzliche Host-Berechtigungen erfordern. Natürlich werden auch Einschränkungen und Begrenzungen in Bezug auf bestimmte Seiten und URI-Schemata angewendet.

In der Regel 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 einen Tab mit der rechten Maustaste anklickt. Das heißt, ein Menü auf einem Element im Tabstreifen, das es dem Benutzer ermöglicht, zwischen Tabs 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, selbst wenn es nicht der aktive Tab ist (ab Firefox 63, Firefox-Bug 1446956).

Zwischenablage-Zugriff

Zwei Berechtigungen ermöglichen es einer Erweiterung, mit der Zwischenablage zu interagieren:

clipboardWrite

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

clipboardRead

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

Siehe Interaktion mit der Zwischenablage für weitere Details.

Unbegrenzter Speicher

Die unlimitedStorage-Berechtigung:

• Ermöglicht Erweiterungen, alle von der storage.local API auferlegten Quoten zu überschreiten.
• Ermöglicht in Firefox Erweiterungen das Erstellen einer "persistenten" IndexedDB-Datenbank ohne, dass der Browser den Benutzer um Erlaubnis bittet, wenn die Datenbank erstellt wird.

Beispiele

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

In Manifest V2 nur, Anforderung privilegierten Zugriffs auf Seiten unter developer.mozilla.org.

  "permissions": ["tabs"]

Anforderung von Zugriff auf die privilegierten Teile der tabs API.

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

In Manifest V2 nur, Anforderung beider oben genannten Berechtigungen.

Browser-Kompatibilität