chrome.permissions

Açıklama

Kavramlar ve kullanım

İzin uyarıları, bir API'nin sağladığı özellikleri açıklamak için bulunur ancak bu uyarılardan bazıları açıkça anlaşılmayabilir. Permissions API, geliştiricilerin izin uyarılarını açıklamalarına ve yeni özellikleri kademeli olarak kullanıma sunmalarına olanak tanır. Böylece, kullanıcılara uzantıyı risksiz bir şekilde tanıtabilirler. Böylece kullanıcılar ne kadar erişim vermek istediklerini ve hangi özellikleri etkinleştirmek istediklerini belirleyebilir.

Ö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 o gün hedefini gösteriyor. Bu özellik yalnızca depolama iznini gerektirir. 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 sitelerini görüntülemek 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, hangilerinin isteğe bağlı olduğuna karar verin

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

• Gerekli izinleri, uzantınızın temel işlevi için gerekli olduğunda 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: Bir uzantı, kullanıcıdan tüm izinleri kabul etmesini bir kez isteyebilir.
• Daha basit geliştirme: Gerekli izinlerin mevcut olması garanti edilir.

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

• Daha iyi güvenlik: Kullanıcılar yalnızca izinleri etkinleştirdiğinden uzantılar daha az izinle çalışır. bunları inceleyeceğiz.
• Kullanıcılar için daha iyi bilgiler: Uzantılar, neden belirli bir izne ihtiyaç duyduğunu açıklayabilir Kullanıcı ilgili özelliği etkinleştirdiğinde
• Daha kolay yükseltme: Uzantınızı yeni sürüme geçirdiğinizde Chrome, Yükseltme, gerekli yerine isteğe bağlı izinler ekler.

2. Adım: Manifest'te isteğe bağlı izinleri beyan edin

Uzantı manifestinizde isteğe bağlı izinleri optional_permissions anahtarıyla bildirin. izinler alanıyla aynı biçimi kullanın:

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

Yalnızca çalışma zamanında keşfettiğiniz ana makineleri istemek istiyorsanız uzantınızın optional_host_permissions alanına "https://*/*" ifadesini ekleyin. Bu şekilde, "Permissions.origins" içinde eşleşen bir kaynak olduğu sürece herhangi bir kaynağı belirtebilirsiniz. şema.

İsteğe bağlı olarak belirtilemeyen izinler

Aşağıdaki istisnalarla çoğu Chrome uzantı izni isteğe bağlı olarak belirtilebilir.

Mevcut izinler hakkında daha fazla bilgi için İzin beyan etme bölümünü inceleyin ve uyarılarını dikkate alın.

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

permissions.request() işlevini kullanarak bir kullanıcı hareketinin içinden izinleri 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();
    }
  });
});

Chrome, izinlerin eklenmesinden farklı uyarı mesajları ile sonuçlanırsa Chrome, kullanıcıdan gördüğü ve kabul ettiği anlamına gelir. Örneğin, önceki kod şöyle bir istemle sonuçlanabilir: bu:

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():

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ısı yapıldığında genellikle kullanıcıya sormadan izin eklenir.

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