chrome.extension

Açıklama

chrome.extension API, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar içerir. Bu araç, İleti Aktarma bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile onun içerik komut dosyaları veya uzantılar arasında mesaj alışverişinde bulunma desteği içerir.

Türler

ViewType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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

Enum

"sekme"

"popup"

Özellikler

inIncognitoContext

Gizli sekmelerde çalışan içerik komut dosyaları ve gizli bir işlem içinde çalışan uzantı sayfaları için doğru değerini döndürür. İkincisi yalnızca "bölünmüş" uzantılar için geçerlidir gizli_davranış.

Tür

boolean

lastError

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

Lütfen runtime.lastError kullanın.

Eşzamansız bir uzantı API'si hatayla sonuçlandıysa geri çağırmanın ömrü boyunca ayarlanır. Hata oluşmadıysa lastError değeri undefined olur.

Tür

nesne

Özellikler

  • mesaj

    dize

    Ortaya çıkan hatanın açıklaması.

Yöntemler

getBackgroundPage()

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

JavaScript "window" (pencere) değerini döndürür nesnesini ifade eder. Uzantının arka plan sayfası yoksa boş 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,
)

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

Bir JavaScript "window" dizisini döndürür her bir sekmeye ait nesneleri tanımlamak önemlidir. windowId belirtilirse yalnızca "window" (pencere) değerini döndürür belirtilen pencereye ekli sekme nesneleri.

Parametreler

  • windowId

    sayı isteğe bağlı

İadeler

  • Pencere[]

    Genel pencere nesneleri dizisi

getURL()

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

Lütfen runtime.getURL kullanın.

Bir uzantı yükleme dizini içindeki göreli bir yolu, tam nitelikli bir URL'ye dönüştürür.

Parametreler

  • yol

    dize

    Bir uzantı içindeki kaynağa giden ve yükleme dizinine göre belirtilen yol.

İadeler

  • dize

    Kaynağın tam nitelikli URL'si.

getViews()

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

Bir JavaScript "window" dizisini döndürür nesneleri tanımlamak önemlidir.

Parametreler

  • fetchProperties

    nesne isteğe bağlı

    • tabId

      sayı isteğe bağlı

      Chrome 54 ve sonraki sürümler 'nı inceleyin.

      Sekme kimliğine göre bir görünüm bulun. 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 tüm görünümleri döndürür (arka plan sayfaları ve sekmeler dahil).

    • windowId

      sayı 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()

Söz 'nı inceleyin.
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

Uzantının "file://" öğesine erişim durumunu alır şema. Bu, kullanıcı tarafından denetlenen her uzantı için "Dosya URL'lerine erişime izin ver"e karşılık gelir ayara chrome://extensions sayfasından erişebilirsiniz.

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://" öğesine erişebiliyorsa doğru değerini döndürür şema, aksi takdirde false (yanlış) değerini alır.

İadeler

  • Promise<boolean>

    Chrome 99 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

isAllowedIncognitoAccess()

Söz 'nı inceleyin.
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

Uzantının Gizli moda erişim durumunu alır. Bu, kullanıcı tarafından kontrol edilen her uzantı için "Gizli modda izin verilir"e karşılık gelir ayara chrome://extensions sayfasından erişebilirsiniz.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      boolean

      Uzantının Gizli moda erişimi varsa doğru, gizli moda erişimi varsa yanlış değerini alır.

İadeler

  • Promise<boolean>

    Chrome 99 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

sendRequest()

Söz ≤ MV2 Desteği sonlandırıldı
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
)

Lütfen runtime.sendMessage kullanın.

Uzantı içindeki 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

    dize 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

  • geri çağırma

    işlev isteğe bağlı

    Chrome 99 ve sonraki sürümler 'nı inceleyin.

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

    (response: any) => void

    • yanıt

      herhangi

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

İadeler

  • Söz veriyorum<herhangi biri>

    Chrome 99 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması 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ı Galerisi'nde barındırılan uzantılar için yoksayılır.

Parametreler

  • veri

    dize

Etkinlikler

onRequest

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

Lütfen runtime.onMessage kullanın.

Uzantı işleminden 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

&amp;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

  • 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