chrome.extension

refresh date: 2026-09-25 robots: noindex

Açıklama

chrome.extension API'si, herhangi bir uzantı sayfası tarafından kullanılabilen yardımcı programlara sahiptir. Mesaj Aktarma bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içerik komut dosyaları arasında veya uzantılar arasında mesaj alışverişi desteği içerir.

Türler

ViewType

Chrome 44+

Uzantı görünümünün türü.

Enum

"tab"

"popup"

Özellikler

inIncognitoContext

Gizli sekmelerde çalışan içerik komut dosyaları ve gizli işlemde çalışan uzantı sayfaları için True değerini alır. İkincisi yalnızca "split" incognito_behavior değerine sahip uzantılar için geçerlidir.

Tür

boole

lastError

≤ MV2 Chrome 58'den itibaren desteği sonlandırıldı

Lütfen runtime.lastError kullanın.

Asenkron bir uzantı API'si hatayla sonuçlandıysa geri çağırmanın kullanım ömrü için ayarlanır. Hata oluşmadıysa lastError undefined olur.

Tür

nesne

Özellikler

  • mesaj

    dize

    Oluşan hatanın açıklaması.

Yöntemler

getBackgroundPage()

Yalnızca ön plan 
chrome.extension.getBackgroundPage(): Window | undefined

Geçerli uzantıda çalışan arka plan sayfası için JavaScript "window" nesnesini döndürür. Uzantının arka plan sayfası yoksa null değerini döndürür.

İadeler

  • Pencere | tanımsız

getExtensionTabs()

≤ MV2 Yalnızca ön plan Desteği sonlandırıldı
chrome.extension.getExtensionTabs(
  windowId?: number,
): Window[]

Lütfen extension.getViews {type: "tab"} kullanın.

Mevcut uzantıda çalışan sekmelerin her biri için JavaScript "window" nesnelerinden oluşan bir dizi döndürür. windowId belirtilirse yalnızca belirtilen pencereye eklenen sekmelerin "pencere" nesnelerini döndürür.

Parametreler

  • windowId

    number isteğe bağlı

İadeler

  • Pencere[]

    Genel pencere nesneleri dizisi

getURL()

≤ MV2 Chrome 58'den itibaren desteği sonlandırıldı
chrome.extension.getURL(
  path: string,
): string

Lütfen runtime.getURL kullanın.

Uzantı yükleme dizinindeki göreli yolu tam nitelikli bir URL'ye dönüştürür.

Parametreler

  • yol

    dize

    Bir uzantıdaki kaynağın, yükleme dizinine göre ifade edilen yolu.

İadeler

  • dize

    Kaynağın tam nitelikli URL'si.

getViews()

Yalnızca ön plan 
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

Mevcut uzantıda çalışan sayfaların her biri için JavaScript "window" nesnelerinin bir dizisini döndürür.

Parametreler

  • fetchProperties

    isteğe bağlı nesne

    • tabId

      number isteğe bağlı

      Chrome 54+

      Sekme kimliğine göre görünüm bulma Bu alan atlanırsa tüm görünümler döndürülür.

    • tür

      ViewType isteğe bağlı

      Alınacak görünümün türü. Atlanırsa tüm görünümleri (arka plan sayfaları ve sekmeler dahil) döndürür.

    • windowId

      number isteğe bağlı

      Aramanın kısıtlanacağı pencere. Atlanırsa tüm görünümleri döndürür.

İadeler

  • Pencere[]

    Genel nesneler dizisi

isAllowedFileSchemeAccess()

Taahhüt 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
): Promise<boolean>

Uzantının "file://" şemasına erişim durumunu alır. Bu, chrome://extensions sayfasından erişilebilen, kullanıcı tarafından kontrol edilen uzantı başına "Dosya URL'lerine erişime izin ver" ayarına karşılık gelir.

Parametreler

  • callback

    function isteğe bağlı

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boole

      Uzantı "file://" şemasına erişebiliyorsa doğru, aksi takdirde yanlış değerini döndürür.

İadeler

  • Promise<boolean>

    Chrome 99 ve sonraki sürümler

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

isAllowedIncognitoAccess()

Taahhüt 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
): Promise<boolean>

Uzantının gizli moda erişim durumunu alır. Bu, chrome://extensions sayfasından erişilebilen, kullanıcı tarafından kontrol edilen uzantı başına "Gizli modda izin verilir" ayarına karşılık gelir.

Parametreler

  • callback

    function isteğe bağlı

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boole

      Uzantının Gizli moda erişimi varsa doğru, yoksa yanlış değerini döndürür.

İadeler

  • Promise<boolean>

    Chrome 99 ve sonraki sürümler

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

sendRequest()

Promise &leq; MV2 Desteği sonlandırıldı
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
): Promise<any>

Lütfen runtime.sendMessage kullanın.

Uzantıdaki diğer dinleyicilere tek bir istek gönderir. runtime.connect özelliğine benzer ancak isteğe bağlı bir yanıtla yalnızca tek bir istek gönderir. extension.onRequest etkinliği, uzantının her sayfasında tetiklenir.

Parametreler

  • extensionId

    string isteğe bağlı

    Bağlanmak istediğiniz uzantının uzantı kimliği. Atlanırsa varsayılan olarak kendi uzantınız kullanılır.

  • istek

    herhangi

  • callback

    function isteğe bağlı

    Chrome 99 ve sonraki sürümler

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

    (response: any) => void

    • gönderin

      herhangi

      İsteği işleyen tarafından gönderilen JSON yanıt nesnesi. Uzantıya bağlanırken bir hata oluşursa promise reddedilir.

İadeler

  • Promise<any>

    Chrome 99 ve sonraki sürümler

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

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
): void

Uzantının güncelleme URL'sinde kullanılan ap CGI parametresinin değerini ayarlar. Chrome Uzantı Galerisi'nde barındırılan uzantılar için bu değer yoksayılır.

Parametreler

  • veri

    dize

Etkinlikler

onRequest

&leq; MV2 Desteği sonlandırıldı
chrome.extension.onRequest.addListener(
  callback: function,
)

Lütfen runtime.onMessage kullanın.

Bir uzantı işleminden veya içerik komut dosyasından istek gönderildiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • istek

      herhangi

    • sendResponse

      işlev

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

      () => void

onRequestExternal

&leq; MV2 Desteği sonlandırıldı
chrome.extension.onRequestExternal.addListener(
  callback: function,
)

Lütfen runtime.onMessageExternal kullanın.

Başka bir uzantıdan istek gönderildiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

    • istek

      herhangi

    • sendResponse

      işlev

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

      () => void