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.browserAction

refresh date: 2026-09-25 robots: noindex

Açıklama

Adres çubuğunun sağındaki ana Google Chrome araç çubuğuna simge yerleştirmek için tarayıcı işlemlerini kullanın. Tarayıcı işleminin simgesine ek olarak ipucu, rozeti ve pop-up'ı olabilir.

Kullanılabilirlik

&leq; MV2

Aşağıdaki resimde, adres çubuğunun sağındaki çok renkli kare, tarayıcı işleminin simgesidir. Simgenin altında bir pop-up var.

Her zaman etkin olmayan bir simge oluşturmak istiyorsanız tarayıcı işlemi yerine sayfa işlemi kullanın.

Manifest

Tarayıcı işleminizi uzantı manifestine şu şekilde kaydedin:

{
  "name": "My extension",
  ...
  "browser_action": {
    "default_icon": {                // optional
      "16": "images/icon16.png",     // optional
      "24": "images/icon24.png",     // optional
      "32": "images/icon32.png"      // optional
    },
    "default_title": "Google Mail",  // optional, shown in tooltip
    "default_popup": "popup.html"    // optional
  },
  ...
}

Chrome'da kullanılacak herhangi bir boyutta simge sağlayabilirsiniz. Chrome, en yakın boyutu seçer ve 16 dip'lik alanı doldurmak için uygun boyuta ölçeklendirir. Ancak tam boyut sağlanmazsa bu ölçeklendirme, simgenin ayrıntılarını kaybetmesine veya bulanık görünmesine neden olabilir.

1,5x veya 1,2x gibi daha az yaygın ölçeklendirme faktörlerine sahip cihazlar daha yaygın hale geldiğinden simgeleriniz için birden fazla boyut sağlamanız önerilir. Bu sayede, simge görüntüleme boyutu değişirse farklı simgeler sağlamak için daha fazla çalışma yapmanız gerekmez.

Varsayılan simgeyi kaydetmek için kullanılan eski söz dizimi hâlâ desteklenmektedir:

{
  "name": "My extension",
  ...
  "browser_action": {
    ...
    "default_icon": "images/icon32.png"  // optional
    // equivalent to "default_icon": { "32": "images/icon32.png" }
  },
  ...
}

Kullanıcı arayüzünün bölümleri

Tarayıcı işlemlerinde simge, ipucu, rozet ve pop-up bulunabilir.

Simge

Chrome'daki tarayıcı işlemi simgeleri 16 dip (cihazdan bağımsız piksel) genişliğinde ve yüksekliğindedir. Daha büyük simgeler sığacak şekilde yeniden boyutlandırılır ancak en iyi sonuçlar için 16 dip kare simge kullanın.

Simgeyi iki şekilde ayarlayabilirsiniz: statik bir resim kullanarak veya HTML5 canvas öğesini kullanarak. Basit uygulamalar için statik resimler kullanmak daha kolaydır ancak canvas öğesini kullanarak akıcı animasyon gibi daha dinamik kullanıcı arayüzleri oluşturabilirsiniz.

Statik resimler BMP, GIF, ICO, JPEG veya PNG dahil olmak üzere WebKit'in görüntüleyebileceği herhangi bir biçimde olabilir. Paketlenmemiş uzantılar için resimler PNG biçiminde olmalıdır.

Simgeyi ayarlamak için manifest dosyasındaki browser_action öğesinin default_icon alanını kullanın veya browserAction.setIcon yöntemini çağırın.

Ekran piksel yoğunluğu (oran size_in_pixel / size_in_dip) 1'den farklı olduğunda simgenin düzgün şekilde gösterilmesi için simge, farklı boyutlarda resim grubu olarak tanımlanabilir. Gösterilecek gerçek resim, 16 dip piksel boyutuna en uygun şekilde kümeden seçilir. Simge grubu, herhangi bir boyutta simge spesifikasyonu içerebilir ve Chrome en uygun olanı seçer.

İpucunu ayarlamak için manifest dosyasındaki browser_action öğesinin default_title alanını kullanın veya browserAction.setTitle yöntemini çağırın. default_title alanı için yerel ayara özel dizeler belirtebilirsiniz. Ayrıntılar için Uluslararası hale getirme konusuna bakın.

Rozet

Tarayıcı işlemleri isteğe bağlı olarak bir rozet (simgenin üzerine yerleştirilmiş bir metin parçası) gösterebilir. Rozetler, uzantının durumu hakkında az miktarda bilgi görüntülemek için tarayıcı işlemini güncellemeyi kolaylaştırır.

Rozette sınırlı alan olduğundan 4 karakter veya daha az karakter içermelidir.

Sırasıyla browserAction.setBadgeText ve browserAction.setBadgeBackgroundColor kullanarak rozetin metnini ve rengini ayarlayın.

Tarayıcı işleminin bir pop-up'ı varsa kullanıcı uzantının simgesini tıkladığında pop-up görünür. Pop-up, istediğiniz HTML içeriğini barındırabilir ve içeriğine sığacak şekilde otomatik olarak boyutlandırılır. Pop-up 25x25'ten küçük ve 800x600'den büyük olamaz.

Tarayıcı işleminize pop-up eklemek için pop-up'ın içeriğini içeren bir HTML dosyası oluşturun. Manifest'teki default_popup öğesinin default_popup alanında HTML dosyasını belirtin veya browserAction.setPopup yöntemini çağırın.

İpuçları

En iyi görsel etki için aşağıdaki yönergeleri uygulayın:

Çoğu sayfada anlamlı olan özellikler için tarayıcı işlemlerini kullanın.
Yalnızca birkaç sayfa için anlamlı olan özelliklerde tarayıcı işlemlerini kullanmayın. Bunun yerine sayfa işlemlerini kullanın.
16x16 dip alanından en iyi şekilde yararlanan büyük, renkli simgeler kullanın. Tarayıcı işlemi simgeleri, sayfa işlemi simgelerinden biraz daha büyük ve ağır görünmelidir.
Google Chrome'un tek renkli menü simgesini taklit etmeye çalışmayın. Bu, temalarla iyi çalışmaz ve zaten uzantıların biraz öne çıkması gerekir.
Simgenize yumuşak kenarlar eklemek için alfa şeffaflığı kullanın. Birçok kullanıcı tema kullandığından simgeniz çeşitli arka plan renklerinde güzel görünmelidir.
Simgenizi sürekli animasyonlu hale getirmeyin. Bu can sıkıcı bir durum.

Örnekler

Tarayıcı işlemlerini kullanmayla ilgili basit örnekleri examples/api/browserAction dizininde bulabilirsiniz. Diğer örnekler ve kaynak kodunu görüntüleme konusunda yardım için Örnekler'e bakın.

Türler

TabDetails

Chrome 88+

Özellikler

tabId

number isteğe bağlı

Durumu sorgulanacak sekmenin kimliği. Sekme belirtilmezse sekmeye özgü olmayan durum döndürülür.

Yöntemler

disable()

Taahhüt

chrome.browserAction.disable(
  tabId?: number,
  callback?: function,
): Promise<void>

Bir sekme için tarayıcı işlemini devre dışı bırakır.

Parametreler

tabId

number isteğe bağlı

Tarayıcı işleminin değiştirileceği sekmenin kimliği.
callback

function isteğe bağlı

Chrome 67 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88+

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

enable()

Taahhüt

chrome.browserAction.enable(
  tabId?: number,
  callback?: function,
): Promise<void>

Bir sekme için tarayıcı işlemini etkinleştirir. Varsayılan olarak etkindir.

Parametreler

tabId

number isteğe bağlı

Tarayıcı işleminin değiştirileceği sekmenin kimliği.
callback

function isteğe bağlı

Chrome 67 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88+

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

getBadgeBackgroundColor()

Taahhüt

chrome.browserAction.getBadgeBackgroundColor(
  details: TabDetails,
  callback?: function,
): Promise<extensionTypes.ColorArray>

Tarayıcı işleminin arka plan rengini alır.

Parametreler

ayrıntılar

TabDetails
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result: ColorArray) => void
```
- sonuç
  
  ColorArray

İadeler

Promise<extensionTypes.ColorArray>

Chrome 88+

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

getBadgeText()

Taahhüt

chrome.browserAction.getBadgeText(
  details: TabDetails,
  callback?: function,
): Promise<string>

Tarayıcı işleminin rozet metnini alır. Sekme belirtilmezse sekmeye özel olmayan rozet metni döndürülür.

Parametreler

ayrıntılar

TabDetails
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result: string) => void
```
- sonuç
  
  dize

İadeler

Promise<string>

Chrome 88+

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

getPopup()

Taahhüt

chrome.browserAction.getPopup(
  details: TabDetails,
  callback?: function,
): Promise<string>

Bu tarayıcı işlemi için pop-up olarak ayarlanan HTML belgesini alır.

Parametreler

ayrıntılar

TabDetails
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result: string) => void
```
- sonuç
  
  dize

İadeler

Promise<string>

Chrome 88+

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

getTitle()

Taahhüt

chrome.browserAction.getTitle(
  details: TabDetails,
  callback?: function,
): Promise<string>

Tarayıcı işleminin başlığını alır.

Parametreler

ayrıntılar

TabDetails
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result: string) => void
```
- sonuç
  
  dize

İadeler

Promise<string>

Chrome 88+

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

setBadgeBackgroundColor()

Taahhüt

chrome.browserAction.setBadgeBackgroundColor(
  details: object,
  callback?: function,
): Promise<void>

Rozetin arka plan rengini ayarlar.

Parametreler

ayrıntılar

nesne
- renk
  
  string | ColorArray
  
  Rozetin RGBA rengini oluşturan 0-255 aralığında dört tam sayıdan oluşan bir dizi. CSS onaltılık renk değeri içeren bir dize de olabilir (ör. #FF0000 veya #F00 (kırmızı)). Renkleri tam opaklıkta oluşturur.
- tabId
  
  number isteğe bağlı
  
  Değişikliği, belirli bir sekme seçildiğinde geçerli olacak şekilde sınırlandırır. Sekme kapatıldığında otomatik olarak sıfırlanır.
callback

function isteğe bağlı

Chrome 67 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88+

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

setBadgeText()

Taahhüt

chrome.browserAction.setBadgeText(
  details: object,
  callback?: function,
): Promise<void>

Tarayıcı işlemi için rozet metnini ayarlar. Rozet, simgenin üst kısmında gösterilir.

Parametreler

ayrıntılar

nesne
- tabId
  
  number isteğe bağlı
  
  Değişikliği, belirli bir sekme seçildiğinde geçerli olacak şekilde sınırlandırır. Sekme kapatıldığında otomatik olarak sıfırlanır.
- text (metin)
  
  string isteğe bağlı
  
  İstediğiniz sayıda karakter girebilirsiniz ancak alana yalnızca yaklaşık dört karakter sığar. Boş bir dize ('') iletilirse rozet metni temizlenir. tabId belirtilir ve text boş bırakılırsa belirtilen sekmenin metni temizlenir ve varsayılan olarak genel rozet metni kullanılır.
callback

function isteğe bağlı

Chrome 67 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88+

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

setIcon()

Taahhüt

chrome.browserAction.setIcon(
  details: object,
  callback?: function,
): Promise<void>

Tarayıcı işlemi için simgeyi ayarlar. Simge, bir resim dosyasının yolu, bir tuval öğesinden alınan piksel verileri veya bunlardan birinin sözlüğü olarak belirtilebilir. path veya imageData özelliği belirtilmelidir.

Parametreler

ayrıntılar

nesne
- imageData
  
  ImageData | nesne isteğe bağlı
  
  Ayarlanacak simgeyi temsil eden bir ImageData nesnesi veya {size -> ImageData} sözlüğü. Simge bir sözlük olarak belirtilirse kullanılan resim, ekranın piksel yoğunluğuna göre seçilir. Bir ekran alanı birimine sığan resim piksellerinin sayısı scale ise scale * n boyutunda bir resim seçilir. Burada n, kullanıcı arayüzündeki simgenin boyutudur. En az bir resim belirtilmelidir. 'details.imageData = foo' ifadesinin 'details.imageData = {'16': foo}' ifadesine eşdeğer olduğunu unutmayın.
- yol
  
  string | object isteğe bağlı
  
  Ayarlanacak bir simgeyi işaret eden göreli resim yolu veya sözlük {size -> relative image path}. Simge bir sözlük olarak belirtilirse kullanılan resim, ekranın piksel yoğunluğuna göre seçilir. Bir ekran alanı birimine sığan resim pikseli sayısı scale ise scale * n boyutunda bir resim seçilir. Burada n, kullanıcı arayüzündeki simgenin boyutudur. En az bir resim belirtilmelidir. "details.path = foo" ifadesinin "details.path = {'16': foo}" ifadesine eşdeğer olduğunu unutmayın.
- tabId
  
  number isteğe bağlı
  
  Değişikliği, belirli bir sekme seçildiğinde geçerli olacak şekilde sınırlandırır. Sekme kapatıldığında otomatik olarak sıfırlanır.
callback

function isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 116+

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

setPopup()

Taahhüt

chrome.browserAction.setPopup(
  details: object,
  callback?: function,
): Promise<void>

Kullanıcı, tarayıcı işlemi simgesini tıkladığında açılacak HTML belgesini pop-up olarak ayarlar.

Parametreler

ayrıntılar

nesne
- pop-up
  
  dize
  
  Pop-up'ta gösterilecek HTML dosyasının göreli yolu. Boş dizeye ('') ayarlanırsa pop-up gösterilmez.
- tabId
  
  number isteğe bağlı
  
  Değişikliği, belirli bir sekme seçildiğinde geçerli olacak şekilde sınırlandırır. Sekme kapatıldığında otomatik olarak sıfırlanır.
callback

function isteğe bağlı

Chrome 67 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88+

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

setTitle()

Taahhüt

chrome.browserAction.setTitle(
  details: object,
  callback?: function,
): Promise<void>

Tarayıcı işleminin başlığını ayarlar. Bu başlık, ipucunda görünür.

Parametreler

ayrıntılar

nesne
- tabId
  
  number isteğe bağlı
  
  Değişikliği, belirli bir sekme seçildiğinde geçerli olacak şekilde sınırlandırır. Sekme kapatıldığında otomatik olarak sıfırlanır.
- title
  
  dize
  
  Fareyle üzerine gelindiğinde tarayıcı işleminin göstermesi gereken dize.
callback

function isteğe bağlı

Chrome 67 ve sonraki sürümler

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88+

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

Etkinlikler

onClicked

chrome.browserAction.onClicked.addListener(
  callback: function,
)

Bir tarayıcı işlemi simgesi tıklandığında tetiklenir. Tarayıcı işleminde pop-up varsa tetiklenmez.

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(tab: tabs.Tab) => void
```
- sekme
  
  tabs.Tab

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

Açıklama

Kullanılabilirlik

Manifest

Kullanıcı arayüzünün bölümleri

Simge

İpucu

Rozet

Pop-up

İpuçları

Örnekler

Türler

TabDetails

Özellikler

Yöntemler

disable()

Parametreler

İadeler

enable()

Parametreler

İadeler

getBadgeBackgroundColor()

Parametreler

İadeler

getBadgeText()

Parametreler

İadeler

getPopup()

Parametreler

İadeler

getTitle()

Parametreler

İadeler

setBadgeBackgroundColor()

Parametreler

İadeler

setBadgeText()

Parametreler

İadeler

setIcon()

Parametreler

İadeler

setPopup()

Parametreler

İadeler

setTitle()

Parametreler

İadeler

Etkinlikler

onClicked

Parametreler

chrome.browserAction