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
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
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()
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()
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()
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()
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()
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.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
isAllowedIncognitoAccess()
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.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
sendRequest()
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.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
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
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
-
gönderen
-
sendResponse
işlev
sendResponse
parametresi şu şekilde görünür:() => void
-
onRequestExternal
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
-
gönderen
-
sendResponse
işlev
sendResponse
parametresi şu şekilde görünür:() => void
-