Açıklama
chrome.extension
API, herhangi bir uzantı sayfası tarafından kullanılabilecek yardımcı programlar içerir. İleti Aktarma bölümünde ayrıntılı olarak açıklandığı gibi, bir uzantı ile içeriğin komut dosyaları veya uzantılar arasında mesaj alışverişi desteği içerir.
Türler
ViewType
Uzantı görünümünün türü.
Enum
"popup"
Özellikler
inIncognitoContext
Gizli sekmeler içinde çalışan içerik komut dosyaları ve gizli bir işlem içinde çalışan uzantı sayfaları için doğru değerini alır. İkinci kural yalnızca "bölünmüş" Secret_behavior davranışına sahip uzantılar için geçerlidir.
Tür
boolean
lastError
Lütfen runtime.lastError
hesabını kullanın.
Ansychronous uzantı api bir hatayla sonuçlandıysa geri çağırma işleminin kullanım ömrü için ayarlayın. Herhangi bir hata oluşmadıysa lastError değeri undefined
olacaktır.
Tür
nesne
Özellikler
-
mesaj
dize
Oluşan hatanın açıklaması.
Yöntemler
getBackgroundPage()
chrome.extension.getBackgroundPage()
Geçerli uzantının içinde çalışan arka plan sayfası için JavaScript "window" nesnesini döndürür. Uzantının arka plan sayfası yoksa boş sonucunu döndürür.
İlerlemeler
-
Pencere | tanımsız
getExtensionTabs()
chrome.extension.getExtensionTabs(
windowId?: number,
)
Lütfen şunu kullanın: extension.getViews
{type: "tab"}
.
Geçerli uzantının içinde çalışan sekmelerin her biri için JavaScript "window" nesnelerinden oluşan bir dizi döndürür. windowId
belirtilirse yalnızca belirtilen pencereye ekli sekmelerin "window" nesnelerini döndürür.
Parametreler
-
windowId
numara isteğe bağlı
İlerlemeler
-
Pencere[]
Global pencere nesneleri dizisi
getURL()
chrome.extension.getURL(
path: string,
)
Lütfen runtime.getURL
hesabını kullanın.
Uzantı yükleme dizinindeki göreli bir yolu tam nitelikli bir URL'ye dönüştürür.
Parametreler
-
yol
dize
Uzantı içindeki bir kaynağın yükleme dizinine göre ifade edilen yolu.
İlerlemeler
-
dize
Kaynağın tam nitelikli URL'si.
getViews()
chrome.extension.getViews(
fetchProperties?: object,
)
Geçerli uzantının içinde çalışan sayfaların her biri için JavaScript "window" nesnelerinden oluşan bir dizi döndürür.
Parametreler
-
fetchProperties
isteğe bağlı
-
tabId
numara isteğe bağlı
Chrome 54 ve sonraki sürümlerSekme kimliğine göre bir görünüm bulun. Bu alan atlanırsa tüm görünümleri döndürür.
-
tür
ViewType isteğe bağlı
Elde edilecek görüntüleme türüdür. Atlanırsa tüm görünümleri (arka plan sayfaları ve sekmeler dahil) döndürür.
-
windowId
numara isteğe bağlı
Aramanın kısıtlanacağı pencere. Atlanırsa tüm görüntülemeleri döndürür.
-
İlerlemeler
-
Pencere[]
Küresel nesneler dizisi
isAllowedFileSchemeAccess()
chrome.extension.isAllowedFileSchemeAccess(
callback?: function,
)
Uzantının "file://" şemasına erişim durumunu alır. Bu, chrome://extensions sayfasından erişilebilen, her uzantı için kullanıcı tarafından denetlenen "Dosya URL'lerine erişime izin ver" ayarına karşılık gelir.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(isAllowedAccess: boolean) => void
-
isAllowedAccess
boolean
Uzantı "file://" şemasına erişebiliyorsa True, aksi takdirde false değerini alır.
-
İlerlemeler
-
Promise<boolean>
Chrome 99 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
isAllowedIncognitoAccess()
chrome.extension.isAllowedIncognitoAccess(
callback?: function,
)
Uzantının Gizli moda erişim durumunu alır. Bu, chrome://extensions sayfasından erişilebilen, her uzantı için kullanıcı tarafından denetlenen "Gizli modda izin verildi" ayarına karşılık gelir.
Parametreler
-
geri çağırma
Functions (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 moddaysa yanlış değerini alır.
-
İlerlemeler
-
Promise<boolean>
Chrome 99 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
sendRequest()
chrome.extension.sendRequest(
extensionId?: string,
request: any,
callback?: function,
)
Lütfen runtime.sendMessage
hesabını kullanın.
Uzantı içindeki diğer işleyicilere tek bir istek gönderir. runtime.connect
ile benzerdir, ancak yalnızca isteğe bağlı bir yanıtla 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 olur.
-
istek
Tümü
-
geri çağırma
Functions (isteğe bağlı)
Chrome 99 ve sonraki sürümlercallback
parametresi şu şekilde görünür:(response: any) => void
-
yanıt
Tümü
İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Uzantıya bağlanırken bir hata oluşursa geri çağırma bağımsız değişken olmadan çağrılır ve hata mesajı
runtime.lastError
olarak ayarlanır.
-
İlerlemeler
-
Söz<herhangi>
Chrome 99 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setUpdateUrlData()
chrome.extension.setUpdateUrlData(
data: string,
)
Uzantının güncelleme URL'sinde kullanılan ap CGI parametresinin değerini ayarlar. 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
hesabını kullanın.
Uzantı işleminden veya içerik komut dosyasından bir 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
Tümü
-
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
hesabını 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
Tümü
-
gönderen
-
sendResponse
işlev
sendResponse
parametresi şu şekilde görünür:() => void
-