Manifest V2 uzantıları, 31 Ağustos 2026 tarihinde Chrome Web Mağazası'ndan kaldırıldı. Uzantınızı tekrar kullanılabilir hale getirmek için Manifest V3'e taşıyın.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

chrome.permissions

refresh date: 2026-09-25 robots: noindex

Açıklama

Beyan edilen isteğe bağlı izinleri yükleme zamanı yerine çalışma zamanında istemek için chrome.permissions API'sini kullanın. Böylece kullanıcılar izinlerin neden gerekli olduğunu anlayabilir ve yalnızca gerekli olan izinleri verebilir.

Genel Bakış

İzin uyarıları, bir API tarafından sağlanan özellikleri açıklamak için kullanılır ancak bu uyarılardan bazıları net olmayabilir. Permissions API, geliştiricilerin izin uyarılarını açıklamasına ve yeni özellikleri kademeli olarak sunmasına olanak tanır. Bu sayede kullanıcılar, uzantıyı risksiz bir şekilde tanıyabilir. 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ı izinler uzantısının temel işlevi, yeni sekme sayfasını geçersiz kılmaktır. Özelliklerden biri, kullanıcının günlük hedefini gösteriyor. Bu özellik için yalnızca depolama alanı izni gerekir. Bu izin için uyarı gösterilmez. Uzantının, kullanıcıların aşağıdaki düğmeyi tıklayarak etkinleştirebileceği ek bir özelliği var:

Kullanıcının en çok ziyaret ettiği siteleri görüntülemek için topSites izni gerekir. Bu izinle ilgili aşağıdaki uyarı gösterilir.

topSites API için uzantı uyarısı

İsteğe bağlı izinleri uygulama

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

Bir uzantı hem zorunlu 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 zorunlu 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 tüm izinleri kabul etmesini bir kez isteyebilir.
Daha basit geliştirme: Gerekli izinlerin mevcut olduğu garanti edilir.

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

Daha iyi 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 bilgiler: Bir uzantı, kullanıcı ilgili özelliği etkinleştirdiğinde neden belirli bir izne ihtiyaç duyduğunu açıklayabilir.
Daha kolay yükseltmeler: Uzantınızı yükselttiğinizde, yükseltme işlemi zorunlu izinler yerine isteğe bağlı izinler ekliyorsa Chrome, uzantıyı kullanıcılarınız için devre dışı bırakmaz.

2. adım: Manifest dosyasında isteğe bağlı izinleri beyan edin

Uzantı manifestinizde isteğe bağlı izinleri optional_permissions anahtarıyla, permissions alanıyla aynı biçimi kullanarak beyan edin:

{
  "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://*/*" ekleyin. Bu sayede, eşleşen bir şeması olduğu sürece Permissions.origins içinde herhangi bir kaynak belirtebilirsiniz.

İsteğe bağlı olarak belirtilemeyen izinler

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

İzin	Açıklama
`"debugger"`	chrome.debugger API, Chrome'un uzaktan hata ayıklama protokolü için alternatif bir aktarım görevi görür.
`"declarativeNetRequest"`	Uzantıya chrome.declarativeNetRequest API'sine erişim izni verir.
`"devtools"`	Uzantının Chrome Geliştirici Araçları işlevini genişletmesine olanak tanır.
`"experimental"`	Yalnızca Canary ve Yeni geliştirilenler kanalı. Uzantıya chrome.experimental API'lerine erişim izni verir.
`"geolocation"`	Uzantının HTML5 coğrafi konum API'sini kullanmasına izin verir.
`"mdns"`	Uzantıya chrome.mdns API'sine erişim izni verir.
`"proxy"`	Chrome'un proxy ayarlarını yönetmek için uzantıya chrome.proxy API'sine erişim izni verir.
`"tts"`	chrome.tts API, sentezlenmiş metin okuma (TTS) seslerini oynatır.
`"ttsEngine"`	chrome.ttsEngine API, bir uzantı kullanarak metin okuma (TTS) motoru uygular.
`"wallpaper"`	Yalnızca ChromeOS. ChromeOS duvar kağıdını değiştirmek için chrome.wallpaper API'yi kullanın.

Mevcut izinler ve uyarıları hakkında daha fazla bilgi için İzinleri Beyan Etme ve Kullanıcıları Uyarma bölümüne bakın.

3. adım: İsteğe bağlı izinleri talep edin

permissions.request() kullanarak bir kullanıcı hareketi 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();
    }
  });
});

İzinlerin eklenmesi, kullanıcının daha önce görüp kabul ettiğinden farklı uyarı mesajlarına neden olursa Chrome kullanıcıdan onay ister. Örneğin, önceki kod aşağıdaki gibi bir istemle sonuçlanabilir:

örnek izin onayı istemi

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() 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ıldığında genellikle kullanıcıya sorulmadan izin tekrar 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).
  }
});

Türler

Permissions

Özellikler

origins

string[] isteğe bağlı

Manifest dosyasındaki optional_permissions veya permissions anahtarlarında belirtilenler ve içerik komut dosyalarıyla ilişkili olanlar da dahil olmak üzere ana makine izinlerinin listesi.
izinler

string[] isteğe bağlı

Adlandırılmış izinlerin listesi (ana makineleri veya kaynakları içermez).

Yöntemler

contains()

Taahhüt

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

Uzantının belirtilen izinlere sahip olup olmadığını kontrol eder.

Parametreler

izinler

İzinler
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result: boolean) => void
```
- sonuç
  
  boole
  
  Uzantı belirtilen izinlere sahipse True değerini döndürür. Bir kaynak hem isteğe bağlı izin hem de içerik komut dosyası eşleşme kalıbı olarak belirtilirse her iki izin de verilmediği sürece false döndürülür.

İadeler

Promise<boolean>

Chrome 96+

Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAll()

Taahhüt

chrome.permissions.getAll(
  callback?: function,
): Promise<Permissions>

Uzantının mevcut izin grubunu alır.

Parametreler

callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(permissions: Permissions) => void
```
- izinler
  
  İzinler
  
  Uzantının etkin izinleri. origins özelliğinin, manifestteki permissions ve optional_permissions anahtarlarında belirtilen ve içerik komut dosyalarıyla ilişkili izin verilen kaynakları içereceğini unutmayın.

İadeler

Promise<Permissions>

Chrome 96+

Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

remove()

Taahhüt

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

Belirtilen izinlere erişimi kaldırır. İzinler kaldırılırken sorun yaşanırsa vaat reddedilir.

Parametreler

izinler

İzinler
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(removed: boolean) => void
```
- kaldırıldı
  
  boole
  
  İzinler kaldırıldıysa "doğru" değerini döndürür.

İadeler

Promise<boolean>

Chrome 96+

Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

request()

Taahhüt

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
): Promise<boolean>

Belirtilen izinlere erişim isteğinde bulunur ve gerekirse kullanıcıya bir istem gösterir. Bu izinler, manifest dosyasının optional_permissions alanında tanımlanmalı veya kullanıcı tarafından reddedilen gerekli izinler olmalıdır. Kaynak kalıplarındaki yollar yoksayılır. İsteğe bağlı kaynak izinlerinin alt kümelerini isteyebilirsiniz. Örneğin, manifest dosyasının optional_permissions bölümünde *://*\/* değerini belirtirseniz http://example.com/ değerini isteyebilirsiniz. İzinleri istemeyle ilgili herhangi bir sorun varsa vaat reddedilir.

Parametreler

izinler

İzinler
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(granted: boolean) => void
```
- izin verildi
  
  boole
  
  Kullanıcı belirtilen izinleri verdiyse True.

İadeler

Promise<boolean>

Chrome 96+

Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onAdded

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

Uzantı yeni izinler aldığında tetiklenir.

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(permissions: Permissions) => void
```
- izinler
  
  İzinler

onRemoved

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

Uzantıdan izinlere erişim kaldırıldığında tetiklenir.

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(permissions: Permissions) => void
```
- izinler
  
  İzinler

chrome.permissions Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Açıklama

Genel Bakış

İsteğe bağlı izinleri uygulama

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

2. adım: Manifest dosyasında isteğe bağlı izinleri beyan edin

3. adım: İsteğe bağlı izinleri talep edin

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

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

Türler

Permissions

Özellikler

Yöntemler

contains()

Parametreler

İadeler

getAll()

Parametreler

İadeler

remove()

Parametreler

İadeler

request()

Parametreler

İadeler

Etkinlikler

onAdded

Parametreler

onRemoved

Parametreler

chrome.permissions