chrome.extension

Açıklama

chrome.extension API'sinde, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar bulunur. Mesaj Geçişi bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içeriği komut dosyaları veya uzantılar arasında mesaj alışverişi için destek içerir.

Türler

ViewType

Chrome 44 ve sonraki sürümler

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

Enum

"tab"

"popup"

Özellikler

inIncognitoContext

Gizli sekmelerde çalışan içerik komut dosyaları ve gizli bir işlemde çalışan eklenti sayfaları için doğrudur. İkincisi yalnızca incognito_behavior özelliği "split" olan uzantılar için geçerlidir.

Tür

boolean

Yöntemler

getBackgroundPage()

Yalnızca ön plan 
chrome.extension.getBackgroundPage()

Geçerli uzantı içinde çalışan arka plan sayfası için JavaScript "pencere" nesnesini döndürür. Uzantı arka plan sayfası içermiyorsa null değerini döndürür.

İadeler

  • Pencere | undefined

getViews()

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

Geçerli uzantı içinde çalışan her sayfa için JavaScript "pencere" nesnelerinden oluşan bir dizi döndürür.

Parametreler

  • fetchProperties

    nesne isteğe bağlı

    • tabId

      number isteğe bağlı

      Chrome 54 ve sonraki sürümler

      Bir 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 türü. Atlanırsa arka plan sayfaları ve sekmeler dahil tüm görünümleri döndürür.

    • windowId

      number isteğe bağlı

      Aramayı kısıtlayacak pencere. Atlanırsa tüm görünümleri döndürür.

İadeler

  • Window[]

    Global nesne dizisi

isAllowedFileSchemeAccess()

Promise 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

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

İadeler

  • Promise<boolean>

    Chrome 99 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.

isAllowedIncognitoAccess()

Promise 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

      Uzantı Gizli mod'a erişebiliyorsa doğru, aksi takdirde yanlış değerini alır.

İadeler

  • Promise<boolean>

    Chrome 99 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.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

Parametreler

  • veri

    dize

Etkinlikler