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

lastError

≤ MV2 Chrome 58'den beri kullanımdan kaldırıldı

Lütfen runtime.lastError adresini kullanın.

Asenkron uzantı API'si bir hatayla sonuçlandıysa geri çağırma işlevinin ömrü için ayarlanır. Hata oluşmazsa sonHata undefined olur.

Tür

nesne

Özellikler

  • mesaj

    dize

    Gerçekleşen hatanın açıklaması.

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

getExtensionTabs()

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

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

Mevcut uzantı içinde çalışan sekmelerin her biri için JavaScript "pencere" nesnelerinin bir dizisini döndürür. windowId belirtilirse yalnızca belirtilen pencereye bağlı sekmelerin "pencere" nesnelerini döndürür.

Parametreler

  • windowId

    number isteğe bağlı

İadeler

  • Window[]

    Global pencere nesneleri dizisi

getURL()

≤ MV2 Chrome 58'den beri kullanımdan kaldırıldı
chrome.extension.getURL(
  path: string,
)

Lütfen runtime.getURL adresini kullanın.

Bir 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 dizine göre ifade edilen yolu.

İadeler

  • dize

    Kaynağın tam nitelikli URL'si.

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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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 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,
)

Lütfen runtime.sendMessage adresini kullanın.

Uzantıdaki diğer dinleyicilere tek bir istek gönderir. runtime.connect'e benzer ancak isteğe bağlı yanıt içeren tek bir istek gönderir. extension.onRequest etkinliği, uzantının her sayfasında tetiklenir.

Parametreler

  • extensionId

    dize isteğe bağlı

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

  • istek

    herhangi

  • geri çağırma

    işlev isteğe bağlı

    Chrome 99 ve üzeri sürümler

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

    (response: any) => void

    • gönderin

      herhangi

      İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Uzantıya bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

  • Promise<any>

    Chrome 99 ve üzeri sürümler

    Sözler 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,
)

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

onRequest

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

Lütfen runtime.onMessage kullanın.

Bir uzantı sürecinden veya içerik komut dosyasından istek gönderildiğinde tetiklenir.

Parametreler

  • geri çağırma

    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 adresini kullanın.

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

Parametreler

  • geri çağırma

    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