chrome.permissions

Opis

Omówienie

Ostrzeżenia o uprawnieniach opisują możliwości zapewniane przez interfejs API, ale niektóre z nich mogą nie być oczywiste. Interfejs Permissions API pozwala deweloperom wyjaśniać ostrzeżenia o uprawnieniach i stopniowo wprowadzać nowe funkcje, dzięki czemu użytkownicy mogą bez ryzyka zapoznać się z rozszerzeniem. W ten sposób użytkownicy mogą określić poziom dostępu, który chcą przyznać, i funkcje, które chcą włączyć.

Na przykład główna funkcjonalność rozszerzenia uprawnień opcjonalnych zastępuje stronę nowej karty. Jedna z nich to wyświetlanie celu użytkownika na dany dzień. Ta funkcja wymaga tylko uprawnienia do miejsca na dane, które nie wyświetla ostrzeżenia. Rozszerzenie ma dodatkową funkcję, którą użytkownicy mogą włączyć, klikając następujący przycisk:

Aby wyświetlić najpopularniejsze witryny użytkownika, musisz mieć uprawnienie topSites, które zawiera następujące ostrzeżenie.

Wdrażanie opcjonalnych uprawnień

Krok 1. Zdecyduj, które uprawnienia są wymagane, a które opcjonalne

Rozszerzenie może zadeklarować uprawnienia zarówno wymagane, jak i opcjonalne. Ogólne zalecenia:

• Korzystaj z wymaganych uprawnień, gdy są one potrzebne do działania podstawowych funkcji rozszerzenia.
• Używaj uprawnień opcjonalnych, gdy są potrzebne do korzystania z opcjonalnych funkcji w rozszerzeniu.

Zalety wymaganych uprawnień:

• Mniej promptów: rozszerzenie może raz poprosić użytkownika o zaakceptowanie wszystkich uprawnień.
• Prostsze programowanie: wymagane uprawnienia będą gwarantowane.

Zalety opcjonalnych uprawnień:

• Większe bezpieczeństwo: rozszerzenia działają z mniejszymi uprawnieniami, bo użytkownicy tylko włączają uprawnienia które są niezbędne.
• Bardziej przydatne informacje dla użytkowników: rozszerzenie może wyjaśnić, dlaczego potrzebuje określonych uprawnień. gdy użytkownik włączy daną funkcję.
• Łatwiejsze uaktualnianie: gdy uaktualnisz rozszerzenie, Chrome nie wyłączy go dla użytkowników, jeśli uaktualnienie dodaje uprawnienia opcjonalne, a nie wymagane.

Krok 2. Zadeklaruj opcjonalne uprawnienia w pliku manifestu

Zadeklaruj opcjonalne uprawnienia w pliku manifestu rozszerzenia za pomocą klucza optional_permissions. używając tego samego formatu co w polu permissions:

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

Jeśli chcesz wysyłać żądania o hosty wykrywane tylko w czasie działania, w polu optional_host_permissions rozszerzenia wpisz "https://*/*". Dzięki temu w polu Permissions.origins możesz określić dowolne źródło, o ile ma ono dopasowanie oszustw.

Uprawnienia, których nie można określić jako opcjonalne

Większość uprawnień rozszerzeń do Chrome można określić jako opcjonalne z następującymi wyjątkami.

Więcej informacji o dostępnych uprawnieniach znajdziesz w artykule Deklarowanie uprawnień i ostrzeganie użytkowników. ich ostrzeżenia.

Krok 3. Poproś o opcjonalne uprawnienia

Poproś o przyznanie uprawnień gestem użytkownika za pomocą permissions.request():

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();
    }
  });
});

Chrome pyta użytkownika, czy dodanie uprawnień powoduje wyświetlanie innych komunikatów ostrzegawczych niż który użytkownik już widział i zaakceptował. Poprzedni kod może na przykład spowodować wyświetlenie komunikatu to:

Krok 4. Sprawdź bieżące uprawnienia rozszerzenia

Aby sprawdzić, czy rozszerzenie ma określone uprawnienia lub zestaw uprawnień, użyj 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.
  }
});

Krok 5. Usuń uprawnienia

Usuń uprawnienia, gdy już ich nie potrzebujesz. Po usunięciu uprawnienia Wywoływanie permissions.request() zwykle dodaje te uprawnienia bez pytania użytkownika.

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,
)