chrome.permissions

Beschreibung

Konzepte und Nutzung

Berechtigungswarnungen existieren, um die von einer API gewährten Berechtigungen zu beschreiben. Einige dieser Warnungen sind jedoch möglicherweise nicht offensichtlich. Mit der Berechtigungen API können Entwickler Berechtigungswarnungen erklären und nach und nach neue Funktionen einführen. So haben Nutzer eine sichere Einführung in die Erweiterung. Auf diese Weise können Nutzer angeben, wie viel Zugriff sie gewähren möchten und welche Funktionen sie aktivieren möchten.

Beispielsweise überschreibt die Hauptfunktion der optionalen Berechtigungserweiterung die Seite „Neuer Tab“. Eine Funktion ist die Anzeige des Tagesziels der Nutzenden. Für diese Funktion ist nur die Berechtigung Speicher erforderlich, die keine Warnung enthält. Die Erweiterung verfügt über eine zusätzliche Funktion, die Nutzer aktivieren können, indem sie auf die folgende Schaltfläche klicken:

Damit die Top-Websites des Nutzers angezeigt werden können, ist die Berechtigung topSites erforderlich, die die folgende Warnung enthält.

Optionale Berechtigungen implementieren

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

Eine Erweiterung kann sowohl erforderliche als auch optionale Berechtigungen deklarieren. Im Allgemeinen sollten Sie Folgendes tun:

• 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 erforderlicher Berechtigungen:

• Weniger Aufforderungen:Eine Erweiterung kann den Nutzer einmal auffordern, alle Berechtigungen zu gewähren.
• Einfachere Entwicklung:Erforderliche Berechtigungen sind garantiert vorhanden.

Vorteile von optionalen Berechtigungen:

• Bessere Sicherheit:Erweiterungen werden mit weniger Berechtigungen ausgeführt, da Nutzer nur erforderliche Berechtigungen aktivieren.
• Bessere Informationen für Nutzer:Eine Erweiterung kann erklären, warum sie eine bestimmte Berechtigung benötigt, wenn der Nutzer die entsprechende Funktion aktiviert.
• Einfachere Upgrades:Wenn Sie ein Upgrade Ihrer Erweiterung durchführen, wird es von Chrome nicht für Ihre Nutzer deaktiviert, wenn durch das Upgrade optionale statt erforderliche Berechtigungen hinzugefügt werden.

Schritt 2: Optionale Berechtigungen im Manifest deklarieren

Deklarieren Sie optionale Berechtigungen in Ihrem Erweiterungsmanifest 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, geben Sie "https://*/*" in das Feld optional_host_permissions Ihrer Erweiterung ein. Auf diese Weise können Sie einen beliebigen Ursprung in "Permissions.origins" angeben, solange er ein übereinstimmendes Schema hat.

Berechtigungen, die nicht als optional angegeben werden können

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

Unter Erklärung von Berechtigungen finden Sie weitere Informationen zu verfügbaren Berechtigungen und den zugehörigen Warnungen.

Schritt 3: Optionale Berechtigungen anfordern

Fordern Sie die Berechtigungen aus 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();
    }
  });
});

Der Nutzer wird in Chrome gefragt, ob das Hinzufügen der Berechtigungen zu anderen Warnmeldungen führt, als er bereits gesehen und akzeptiert hat. Der vorherige Code könnte beispielsweise so zu einer Eingabeaufforderung führen:

Schritt 4: Aktuelle Berechtigungen der Erweiterung prüfen

Mit permission.contains() kannst du prüfen, ob deine Erweiterung eine bestimmte Berechtigung oder eine Reihe von Berechtigungen hat:

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, wird die Berechtigung durch einen Aufruf von permissions.request() 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,
)