chrome.permissions

Beschreibung

Konzepte und Verwendung

Es gibt Berechtigungswarnungen, um die von einer API gewährten Funktionen zu beschreiben. Einige dieser Warnungen sind jedoch möglicherweise nicht offensichtlich. Mit der Permissions API können Entwickler Berechtigungswarnungen erklären und neue Funktionen schrittweise einführen. So erhalten Nutzer eine risikofreie Einführung in die Erweiterung. So können Nutzer angeben, welche Zugriffsrechte sie gewähren und welche Funktionen sie aktivieren möchten.

Beispielsweise überschreibt die Hauptfunktion der optionalen Erweiterung für Berechtigungen die Seite „Neuer Tab“. Eine Funktion zeigt das Tagesziel der Nutzenden an. Für diese Funktion ist nur die Berechtigung storage erforderlich, die keine Warnung enthält. Die Erweiterung verfügt über eine zusätzliche Funktion, die Nutzer durch Klicken auf die folgende Schaltfläche aktivieren können:

</ph>

Zum Anzeigen der Top-Websites des Nutzers ist die Berechtigung topSites erforderlich, die die folgende Warnung enthält.

</ph>

Optionale Berechtigungen implementieren

Schritt 1: Festlegen, welche Berechtigungen erforderlich und welche optional sind

Über eine Erweiterung können sowohl erforderliche als auch optionale Berechtigungen deklariert werden. Im Allgemeinen gilt Folgendes:

• Verwenden Sie die erforderlichen Berechtigungen, wenn sie für die grundlegenden Funktionen Ihrer Erweiterung erforderlich sind.
• Verwenden Sie optionale Berechtigungen, wenn sie für optionale Funktionen in Ihrer Erweiterung erforderlich sind.

Vorteile der erforderlichen Berechtigungen:

• Weniger Aufforderungen:Eine Erweiterung kann den Nutzer einmal auffordern, alle Berechtigungen zu akzeptieren.
• Einfachere Entwicklung:Die erforderlichen Berechtigungen sind garantiert vorhanden.

Vorteile optionaler Berechtigungen:

• Mehr Sicherheit:Erweiterungen werden mit weniger Berechtigungen ausgeführt, da Nutzer nur Berechtigungen aktivieren. die benötigt werden.
• Bessere Informationen für Nutzer:Eine Erweiterung kann erklären, warum eine bestimmte Berechtigung erforderlich ist. wenn der Nutzer die jeweilige Funktion aktiviert.
• Einfachere Upgrades: Wenn Sie ein Upgrade Ihrer Erweiterung ausführen, wird sie für Ihre Nutzer in den folgenden Fällen nicht deaktiviert: beim Upgrade werden optionale statt erforderliche Berechtigungen hinzugefügt.

Schritt 2: Optionale Berechtigungen im Manifest deklarieren

Deklariere im Erweiterungsmanifest optionale Berechtigungen mit dem Schlüssel optional_permissions. Verwenden Sie dabei dasselbe Format wie im Feld permissions:

{
  "name": "My extension",
  ...
  "optional_permissions": ["tabs"],
  "optional_host_permissions": ["https://www.google.com/"],
  ...
}

Wenn Sie Hosts anfordern möchten, die Sie nur während der Laufzeit erkennen, fügen Sie "https://*/*" in das Feld optional_host_permissions Ihrer Erweiterung ein. So können Sie einen beliebigen Ursprung in "Permissions.origins" angeben, sofern er einen übereinstimmenden .

Berechtigungen, die nicht als optional angegeben werden können

Die meisten Berechtigungen für Chrome-Erweiterungen können optional festgelegt werden. Es gibt jedoch die folgenden Ausnahmen.

Unter Berechtigungen deklarieren finden Sie weitere Informationen zu verfügbaren Berechtigungen und ihre Warnungen.

Schritt 3: Optionale Berechtigungen anfordern

Fordern Sie die Berechtigungen innerhalb einer Nutzergeste mit permissions.request() an:

document.querySelector('#my-button').addEventListener('click', (event) => {
  // Permissions must be requested from inside a user gesture, like a button's
  // click handler.
  chrome.permissions.request({
    permissions: ['tabs'],
    origins: ['https://www.google.com/']
  }, (granted) => {
    // The callback argument will be true if the user granted the permissions.
    if (granted) {
      doSomething();
    } else {
      doSomethingElse();
    }
  });
});

Wenn das Hinzufügen der Berechtigungen andere Warnmeldungen zur Folge hat als die der Nutzer bereits gesehen und akzeptiert hat. Der vorherige Code könnte beispielsweise zu einer Eingabeaufforderung wie der folgenden führen: dies:

</ph>

Schritt 4: Aktuelle Berechtigungen der Erweiterung prüfen

Wenn Sie prüfen möchten, ob Ihre Erweiterung eine bestimmte Berechtigung oder Berechtigung hat, verwenden Sie permission.contains():

chrome.permissions.contains({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (result) => {
  if (result) {
    // The extension has the permissions.
  } else {
    // The extension doesn't have the permissions.
  }
});

Schritt 5: Berechtigungen entfernen

Sie sollten Berechtigungen entfernen, wenn Sie sie nicht mehr benötigen. Nachdem eine Berechtigung entfernt wurde, Durch das Aufrufen von permissions.request() wird die Berechtigung normalerweise wieder hinzugefügt, ohne dass der Nutzer dazu aufgefordert wird.

chrome.permissions.remove({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (removed) => {
  if (removed) {
    // The permissions have been removed.
  } else {
    // The permissions have not been removed (e.g., you tried to remove
    // required permissions).
  }
});

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.getAll(
  callback?: function,
)

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.onAdded.addListener(
  callback: function,
)

chrome.permissions.onRemoved.addListener(
  callback: function,
)