chrome.action

Açıklama

Google Chrome araç çubuğundaki uzantının simgesini kontrol etmek için chrome.action API'sini kullanın.

İşlem simgeleri, çok amaçlı adres çubuğunun yanındaki tarayıcı araç çubuğunda görüntülenir. Yükleme işleminden sonra uzantılar menüsünde (yapboz parçası simgesi) görünür. Kullanıcılar, uzantı simgenizi araç çubuğuna sabitleyebilir.

Kullanılabilirlik

Chrome 88 ve sonraki sürümler MV3 ve sonraki sürümler

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarların manifest dosyasında beyan edilmesi gerekir.

"action"

chrome.action API'yi kullanmak için 3 "manifest_version" belirtin ve "action" anahtarını manifest dosyanıza ekleyin.

{
  "name": "Action Extension",
  ...
  "action": {
    "default_icon": {              // optional
      "16": "images/icon16.png",   // optional
      "24": "images/icon24.png",   // optional
      "32": "images/icon32.png"    // optional
    },
    "default_title": "Click Me",   // optional, shown in tooltip
    "default_popup": "popup.html"  // optional
  },
  ...
}

"action" anahtarı (alt öğeleriyle birlikte) isteğe bağlıdır. Bu dosya dahil edilmediğinde bile uzantınız, uzantının menüsüne erişim sağlamak için araç çubuğunda gösterilir. Bu nedenle, her zaman en azından "action" ve "default_icon" anahtarlarını dahil etmenizi öneririz.

Kavramlar ve kullanım

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

Simge

Simge, uzantınızın araç çubuğundaki ana resimdir ve manifest'inizin "action" anahtarındaki "default_icon" anahtarı tarafından ayarlanır. Simgeler 16 cihazdan bağımsız piksel (DIP) genişliğinde ve yüksekliğinde olmalıdır.

"default_icon" anahtarı, resim yollarının boyutlarını içeren bir sözlüktür. Chrome, kullanılacak resim ölçeğini seçmek için bu simgeleri kullanır. Tam eşleşme bulunamazsa Chrome, mevcut en yakın resmi seçer ve resme sığacak şekilde ölçeklendirir. Bu işlem, resim kalitesini etkileyebilir.

1,5x veya 1,2x gibi daha az yaygın ölçek faktörlerine sahip cihazlar yaygınlaşmaya başladığından simgeleriniz için birden fazla boyut sağlamanızı öneririz. Bu işlem, uzantınızı olası simge görüntüleme boyutu değişikliklerine karşı da gelecekte korur. Ancak yalnızca tek bir boyut sağlanırsa "default_icon" anahtarı, sözlük yerine tek bir simgeye giden yolu içeren bir dize olarak da ayarlanabilir.

Ayrıca, uzantınızın simgesini programlı olarak ayarlamak için action.setIcon()'ü çağırabilirsiniz. Bunun için farklı bir resim yolu belirtebilir veya HTML kanvas öğesini kullanarak dinamik olarak oluşturulmuş bir simge sağlayabilir ya da uzantı hizmet işçisinden ayar yapıyorsanız offscreen kanvas API'sini kullanabilirsiniz.

const canvas = new OffscreenCanvas(16, 16);
const context = canvas.getContext('2d');
context.clearRect(0, 0, 16, 16);
context.fillStyle = '#00FF00';  // Green
context.fillRect(0, 0, 16, 16);
const imageData = context.getImageData(0, 0, 16, 16);
chrome.action.setIcon({imageData: imageData}, () => { /* ... */ });

Paketlenmiş uzantılarda (.crx dosyasından yüklenen) resimler, Blink oluşturma motorunun görüntüleyeceği birçok biçimde (PNG, JPEG, BMP, ICO vb.) olabilir. SVG desteklenmiyor. Paketlenmemiş uzantılar PNG resimleri kullanmalıdır.

İpucu (başlık)

Kullanıcı, fare imlecini araç çubuğundaki uzantı simgesinin üzerinde tuttuğunda ipucu veya başlık görünür. Ayrıca, düğme odaklanıldığında ekran okuyucular tarafından sesli okunan erişilebilir metinde de yer alır.

Varsayılan ipucu, manifest.json öğesindeki "action" anahtarının "default_title" alanı kullanılarak ayarlanır. action.setTitle() öğesini çağırarak bu özelliği programatik olarak da ayarlayabilirsiniz.

Rozet

İşlemler isteğe bağlı olarak simgenin üzerine yerleştirilmiş bir metin olan "rozet" gösterebilir. Bu, işlemi uzantının durumuyla ilgili az miktarda bilgiyi (örneğin, sayaç) görüntüleyecek şekilde güncellemenize olanak tanır. Rozette bir metin bileşeni ve bir arka plan rengi vardır. Alan sınırlı olduğundan rozet metninde dört veya daha az karakter kullanılması önerilir.

Rozet oluşturmak için action.setBadgeBackgroundColor() ve action.setBadgeText() çağrılarını yaparak rozeti programatik olarak ayarlayın. Manifest dosyasında varsayılan bir rozet ayarı yoktur. Rozet rengi değerleri, rozetin RGBA rengini oluşturan 0 ile 255 arasında dört tam sayı dizisi veya CSS rengi değerine sahip bir dize olabilir.

chrome.action.setBadgeBackgroundColor(
  {color: [0, 255, 0, 0]},  // Green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: '#00FF00'},  // Also green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: 'green'},  // Also, also green
  () => { /* ... */ },
);

Kullanıcı, araç çubuğunda uzantının işlem düğmesini tıkladığında bir işlem pop-up'ı gösterilir. Pop-up'ta istediğiniz HTML içeriklerini kullanabilirsiniz. Pop-up, içeriğine sığacak şekilde otomatik olarak boyutlandırılır. Pop-up'ın boyutu 25x25 ile 800x600 piksel arasında olmalıdır.

Pop-up, başlangıçta manifest.json dosyasındaki "action" anahtarındaki "default_popup" mülkü tarafından ayarlanır. Varsa bu özellik, uzantı dizininde bir göreli yolu işaret etmelidir. Ayrıca, action.setPopup() yöntemi kullanılarak farklı bir göreli yola işaret edecek şekilde dinamik olarak güncellenebilir.

Kullanım alanları

Sekme başına durum

Uzantı işlemlerinin her sekme için farklı durumları olabilir. Bir sekme için değer ayarlamak istiyorsanız action API'sinin ayar yöntemlerinde tabId mülkünü kullanın. Örneğin, belirli bir sekmenin rozet metnini ayarlamak için aşağıdaki gibi bir işlem yapın:

function getTabId() { /* ... */}
function getTabBadge() { /* ... */}

chrome.action.setBadgeText(
  {
    text: getTabBadge(tabId),
    tabId: getTabId(),
  },
  () => { ... }
);

tabId özelliği eklenmezse bu ayar genel ayar olarak değerlendirilir. Sekmeye özel ayarlar, genel ayarlara göre önceliklidir.

Etkin durum

Varsayılan olarak, her sekmede araç çubuğu işlemleri etkindir (tıklanabilir). Bunu action.enable() ve action.disable() yöntemlerini kullanarak kontrol edebilirsiniz. Bu yalnızca pop-up'ın (varsa) veya action.onClicked etkinliğinin uzantınıza gönderilip gönderilmeyeceğini etkiler; işlemin araç çubuğundaki varlığını etkilemez.

Örnekler

Aşağıdaki örneklerde, işlemlerin uzantılarda yaygın olarak kullanıldığı bazı yöntemler gösterilmektedir. Bu API'yi denemek için chrome-extension-samples deposundan Action API örneğini yükleyin.

Pop-up göster

Kullanıcı uzantıyla ilgili işlemi tıkladığında uzantıların pop-up göstermesi yaygın bir durumdur. Bunu kendi uzantınıza uygulamak için manifest.json dosyanızda pop-up'ı tanımlayın ve Chrome'un pop-up'ta göstermesi gereken içeriği belirtin.

// manifest.json
{
  "name": "Action popup demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to view a popup",
    "default_popup": "popup.html"
  }
}

<!-- popup.html -->
<!DOCTYPE html>
<html>
<head>
  <style>
    html {
      min-height: 5em;
      min-width: 10em;
      background: salmon;
    }
  </style>
</head>
<body>
  <p>Hello, world!</p>
</body>
</html>

Tıklandığında içerik komut dosyası ekle

Uzantıların yaygın bir özelliği, uzantının işlemini kullanarak birincil özelliklerini göstermesidir. Aşağıdaki örnekte bu kalıp gösterilmektedir. Kullanıcı işlemi tıkladığında uzantı, mevcut sayfaya bir içerik komut dosyası ekler. Ardından içerik komut dosyası, her şeyin beklendiği gibi çalıştığından emin olmak için bir uyarı gösterir.

// manifest.json
{
  "name": "Action script injection demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to show an alert"
  },
  "permissions": ["activeTab", "scripting"],
  "background": {
    "service_worker": "background.js"
  }
}

// background.js
chrome.action.onClicked.addListener((tab) => {
  chrome.scripting.executeScript({
    target: {tabId: tab.id},
    files: ['content.js']
  });
});

// content.js
alert('Hello, world!');

declarativeContent ile işlemleri emüle etme

Bu örnekte, bir uzantının arka plan mantığının (a) bir işlemi varsayılan olarak nasıl devre dışı bırakabileceği ve (b) işlemi belirli sitelerde etkinleştirmek için declarativeContent'i nasıl kullanabileceği gösterilmektedir.

// service-worker.js

// Wrap in an onInstalled callback to avoid unnecessary work
// every time the service worker is run
chrome.runtime.onInstalled.addListener(() => {
  // Page actions are disabled by default and enabled on select tabs
  chrome.action.disable();

  // Clear all rules to ensure only our expected rules are set
  chrome.declarativeContent.onPageChanged.removeRules(undefined, () => {
    // Declare a rule to enable the action on example.com pages
    let exampleRule = {
      conditions: [
        new chrome.declarativeContent.PageStateMatcher({
          pageUrl: {hostSuffix: '.example.com'},
        })
      ],
      actions: [new chrome.declarativeContent.ShowAction()],
    };

    // Finally, apply our new array of rules
    let rules = [exampleRule];
    chrome.declarativeContent.onPageChanged.addRules(rules);
  });
});

Türler

OpenPopupOptions

Chrome 99 ve üzeri sürümler

Özellikler

  • windowId

    sayı isteğe bağlı

    İşlem pop-up'ının açılacağı pencerenin kimliği. Belirtilmezse varsayılan olarak etkin pencere olur.

TabDetails

Özellikler

  • tabId

    number isteğe bağlı

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

UserSettings

Chrome 91 ve sonraki sürümler

Bir uzantının işlemiyle ilgili kullanıcı tarafından belirtilen ayarların koleksiyonu.

Özellikler

  • isOnToolbar

    boolean

    Uzantının işlem simgesinin tarayıcı pencerelerinin üst düzey araç çubuğunda görünür olup olmadığı (yani uzantının kullanıcı tarafından "sabitlenip" sabitlenmediği).

UserSettingsChange

Chrome 130 ve sonraki sürümler

Özellikler

  • isOnToolbar

    boole isteğe bağlı

    Uzantının işlem simgesinin tarayıcı pencerelerinin üst düzey araç çubuğunda görünür olup olmadığı (yani uzantının kullanıcı tarafından "sabitlenip" sabitlenmediği).

Yöntemler

disable()

Söz 
chrome.action.disable(
  tabId?: number,
  callback?: function,
)

Bir sekmenin işlemini devre dışı bırakır.

Parametreler

  • tabId

    sayı isteğe bağlı

    İşlemi değiştirmek istediğiniz sekmenin kimliği.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

enable()

Söz 
chrome.action.enable(
  tabId?: number,
  callback?: function,
)

İşlemi bir sekme için etkinleştirir. İşlemler varsayılan olarak etkindir.

Parametreler

  • tabId

    sayı isteğe bağlı

    İşlemi değiştirmek istediğiniz sekmenin kimliği.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getBadgeBackgroundColor()

Promise 
chrome.action.getBadgeBackgroundColor(
  details: TabDetails,
  callback?: function,
)

İşlemin arka plan rengini alır.

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: ColorArray) => void

İadeler

  • Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getBadgeText()

Söz 
chrome.action.getBadgeText(
  details: TabDetails,
  callback?: function,
)

İşlemin rozet metnini alır. Herhangi bir sekme belirtilmezse sekmeye özel olmayan rozet metni döndürülür. displayActionCountAsBadgeText etkinse declarativeNetRequestFeedback izni mevcut değilse veya sekmeye özgü rozet metni sağlanmadıysa bir yer tutucu metin döndürülür.

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<string>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getBadgeTextColor()

Promise Chrome 110 ve üzeri sürümler 
chrome.action.getBadgeTextColor(
  details: TabDetails,
  callback?: function,
)

İşlemin metin rengini alır.

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: ColorArray) => void

İadeler

  • Promise&lt;browserAction.ColorArray&gt;

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getPopup()

Promise 
chrome.action.getPopup(
  details: TabDetails,
  callback?: function,
)

Bu işlem için pop-up olarak ayarlanan html dokümanını alır.

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<string>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getTitle()

Söz 
chrome.action.getTitle(
  details: TabDetails,
  callback?: function,
)

İşlemin başlığını alır.

Parametreler

  • ayrıntılar

    TabDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: string) => void

    • sonuç

      dize

İadeler

  • Promise<string>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getUserSettings()

Promise Chrome 91 ve sonraki sürümler 
chrome.action.getUserSettings(
  callback?: function,
)

Uzantının işlemiyle ilgili kullanıcı tarafından belirtilen ayarları döndürür.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (userSettings: UserSettings) => void

İadeler

  • Promise<UserSettings>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

isEnabled()

Promise Chrome 110 ve üzeri sürümler 
chrome.action.isEnabled(
  tabId?: number,
  callback?: function,
)

Uzatma işleminin bir sekme için (veya tabId sağlanmamışsa genel olarak) etkinleştirilip etkinleştirilmediğini belirtir. Yalnızca declarativeContent kullanılarak etkinleştirilen işlemler her zaman yanlış değerini döndürür.

Parametreler

  • tabId

    sayı isteğe bağlı

    Etkin durumunu kontrol etmek istediğiniz sekmenin kimliği.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (isEnabled: boolean) => void

    • isEnabled

      boolean

      Uzantı işlemi etkinleştirilirse doğru değerini alır.

İadeler

  • Promise&lt;boolean&gt;

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

openPopup()

Promise Chrome 127 ve üzeri sürümler 
chrome.action.openPopup(
  options?: OpenPopupOptions,
  callback?: function,
)

Uzantının pop-up'ını açar. Chrome 118 ile Chrome 126 arasında bu özellik yalnızca politikayla yüklenen uzantılar tarafından kullanılabilir.

Parametreler

  • seçenekler

    OpenPopupOptions isteğe bağlı

    Pop-up'ın açılmasıyla ilgili seçenekleri belirtir.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setBadgeBackgroundColor()

Promise 
chrome.action.setBadgeBackgroundColor(
  details: object,
  callback?: function,
)

Rozetin arka plan rengini ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • renk

      dize | ColorArray

      Rozetin RGBA rengini oluşturan [0,255] aralığında dört tam sayı dizisi. Örneğin, [255, 0, 0, 255] opak kırmızıdır. CSS değeri içeren bir dize de olabilir. Bu durumda opak kırmızı #FF0000 veya #F00 olur.

    • tabId

      number isteğe bağlı

      Değişikliği belirli bir sekme seçildiğinde olacak şekilde sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setBadgeText()

Söz 
chrome.action.setBadgeText(
  details: object,
  callback?: function,
)

İşlemin rozet metnini ayarlar. Rozet, simgenin üstünde gösterilir.

Parametreler

  • ayrıntılar

    nesne

    • tabId

      number isteğe bağlı

      Değişikliği, belirli bir sekmenin seçildiği zamanla sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

    • text (metin)

      dize isteğe bağlı

      İstediğiniz sayıda karakter iletebilirsiniz ancak alana yalnızca dört karakter sığabilir. Boş bir dize ('') iletilirse rozet metni temizlenir. tabId belirtilir ve text null ise belirtilen sekmenin metni temizlenir ve varsayılan olarak global rozet metni kullanılır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setBadgeTextColor()

Promise Chrome 110 ve üzeri sürümler 
chrome.action.setBadgeTextColor(
  details: object,
  callback?: function,
)

Rozetin metin rengini ayarlar.

Parametreler

  • ayrıntılar

    nesne

    • renk

      dize | ColorArray

      Rozetin RGBA rengini oluşturan [0,255] aralığında dört tam sayı dizisi. Örneğin, opak kırmızı [255, 0, 0, 255]'dır. CSS değeri içeren bir dize de olabilir. Bu durumda opak kırmızı #FF0000 veya #F00 olur. Bu değerin ayarlanmaması durumunda, otomatik olarak rozetin arka plan rengiyle kontrast oluşturan bir renk seçilir ve metin görünür olur. Alfa değeri 0 olan renkler ayarlanmaz ve hata döndürür.

    • tabId

      number isteğe bağlı

      Değişikliği belirli bir sekme seçildiğinde olacak şekilde sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setIcon()

Söz 
chrome.action.setIcon(
  details: object,
  callback?: function,
)

İşlemin simgesini ayarlar. Simge, bir resim dosyasının yolu, bir tuval öğesinden 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 sözlük ({size -> ImageData}). Simge sözlük olarak belirtildiyse kullanılacak asıl resim, ekranın piksel yoğunluğuna bağlı olarak seçilir. Bir ekran alanı birimine sığabilecek 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" değerinin "details.imageData = {'16': foo}" ile eşdeğer olduğunu unutmayın.

    • yol

      dize | nesne isteğe bağlı

      Ayarlanacak simgeye işaret eden göreli bir görüntü yolu veya sözlük {size -> bağıl görüntü yolu}. Simge bir sözlük olarak belirtilirse kullanılacak gerçek resim, ekranın piksel yoğunluğuna bağlı olarak seçilir. Bir ekran alanı birimine sığabilecek resim piksellerinin sayısı scale ise scale * n boyutunda resim seçilir. Burada n, kullanıcı arayüzündeki simgenin boyutudur. En az bir resim belirtilmelidir. "details.path = foo" değerinin "details.path = {'16': foo}" ile eşdeğer olduğunu unutmayın.

    • tabId

      number isteğe bağlı

      Değişikliği belirli bir sekme seçildiğinde olacak şekilde sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<geçersiz>

    Chrome 96 ve üzeri sürümler

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setPopup()

Söz 
chrome.action.setPopup(
  details: object,
  callback?: function,
)

HTML dokümanı, kullanıcı işlemin simgesini tıkladığında pop-up olarak açılacak şekilde ayarlanır.

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 olacak şekilde sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setTitle()

Söz 
chrome.action.setTitle(
  details: object,
  callback?: function,
)

İşlemin başlığını ayarlar. Bu durum ipucuna yansıtılır.

Parametreler

  • ayrıntılar

    nesne

    • tabId

      number isteğe bağlı

      Değişikliği belirli bir sekme seçildiğinde olacak şekilde sınırlar. Sekme kapatıldığında otomatik olarak sıfırlanır.

    • title

      dize

      Fareyle üzerine gelindiğinde işlemin göstermesi gereken dize.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onClicked

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

Bir işlem simgesi tıklandığında tetiklenir. İşlemde bir pop-up varsa bu etkinlik tetiklenmez.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tab: tabs.Tab) => void

onUserSettingsChanged

Chrome 130 ve sonraki sürümler 
chrome.action.onUserSettingsChanged.addListener(
  callback: function,
)

Bir uzantının işlemiyle ilgili kullanıcı tarafından belirtilen ayarlar değiştiğinde tetiklenir.

Parametreler