chrome.permissions

Açıklama

Kavramlar ve kullanım

İzin uyarıları, bir API'nin sunduğu özellikleri açıklamak için bulunur, ancak bu uyarılardan bazıları açıkça belli olmayabilir. Permissions API, geliştiricilerin izin uyarılarını açıklamasına ve yeni özellikleri kademeli olarak tanıtmasına olanak tanır. Böylece, kullanıcılara uzantıyı risksiz bir şekilde tanıtabilir. Böylece kullanıcılar ne kadar erişim izni vermek istediklerini ve hangi özellikleri etkinleştirmek istediklerini belirtebilir.

Örneğin, isteğe bağlı izin uzantısının temel işlevi yeni sekme sayfasını geçersiz kılmaktır. Özelliklerden biri, kullanıcının günün hedefini görüntülemesi. Bu özellik için yalnızca depolama izni gerekir. Bu izin uyarı içermez. Uzantı, kullanıcıların aşağıdaki düğmeyi tıklayarak etkinleştirebileceği ek bir özelliğe sahiptir:

Kullanıcının en popüler sitelerinin gösterilmesi için aşağıdaki uyarının bulunduğu topSites izni gerekir.

İsteğe bağlı izinleri uygulama

1. Adım: Hangi izinlerin gerekli ve hangilerinin isteğe bağlı olduğuna karar verin

Bir uzantı hem gerekli hem de isteğe bağlı izinleri beyan edebilir. Genel olarak şunları yapmalısınız:

• Uzantınızın temel işlevi için gerekli olduğunda gerekli izinleri kullanın.
• Uzantınızdaki isteğe bağlı özellikler için gerektiğinde isteğe bağlı izinleri kullanın.

Gerekli izinlerin avantajları:

• Daha az istem: Uzantı, kullanıcıdan bir kez tüm izinleri kabul etmesini isteyebilir.
• Daha basit geliştirme: Gerekli izinlerin mevcut olacağı garanti edilir.

İsteğe bağlı izinlerin avantajları:

• Daha fazla güvenlik: Kullanıcılar yalnızca gerekli izinleri etkinleştirdiğinden uzantılar daha az izinle çalışır.
• Kullanıcılar için daha iyi bilgi: Uzantı, kullanıcı ilgili özelliği etkinleştirirken neden belirli bir izne ihtiyaç duyduğunu açıklayabilir.
• Daha kolay yeni sürüme geçirme işlemleri: Uzantınızı yeni sürüme geçirdiğinizde, gerekli izinler yerine isteğe bağlı izinler ekliyse Chrome, kullanıcılarınız için uzantıyı devre dışı bırakmaz.

2. Adım: Manifest'te isteğe bağlı izinleri tanımlayın

İzinler alanıyla aynı biçimi kullanarak uzantı manifestinizdeki isteğe bağlı izinleri optional_permissions anahtarıyla bildirin:

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

Yalnızca çalışma zamanında keşfettiğiniz barındırıcıları istemek için uzantınızın optional_host_permissions alanına "https://*/*" değerini ekleyin. Bu, eşleşen bir şemaya sahip olduğu sürece "Permissions.origins" içinde herhangi bir kaynağı belirtebilmenizi sağlar.

İsteğe bağlı olarak belirtilemeyen izinler

Çoğu Chrome uzantı izni, aşağıdaki istisnalar dışında isteğe bağlı olarak belirtilebilir.

Mevcut izinler ve uyarıları hakkında daha fazla bilgi edinmek için İzin Beyan sayfasını görüntüleyin.

3. Adım: İsteğe bağlı izinler isteyin

permissions.request() kullanarak izinleri bir kullanıcı hareketinin içinden isteyin:

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

İzinlerin eklenmesi kullanıcının önceden görüp kabul ettiğinden farklı uyarı mesajlarıyla sonuçlanıyorsa Chrome kullanıcıyı ister. Örneğin, önceki kod şuna benzer bir istemle sonuçlanabilir:

4. Adım: Uzantının mevcut izinlerini kontrol edin

Uzantınızın belirli bir izne veya izin grubuna sahip olup olmadığını kontrol etmek için permission.contains() işlevini kullanın:

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

5. Adım: İzinleri kaldırın

Artık ihtiyaç duymadığınız izinleri kaldırmanız gerekir. Bir izin kaldırıldıktan sonra permissions.request() çağrılması genellikle kullanıcıya sormadan izni geri ekler.

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