Açıklama
chrome.management
API, yüklü ve çalışan uzantıların/uygulamaların listesini yönetmenin yollarını sağlar. Bu, özellikle yerleşik Yeni Sekme sayfasını geçersiz kılan uzantılar için yararlıdır.
İzinler
management
Manifest
Yönetim API'sini kullanmak için uzantı manifestinde "yönetim" iznini beyan etmeniz gerekir. Örneğin:
{
"name": "My extension",
...
"permissions": [
"management"
],
...
}
management.getPermissionWarningsByManifest
, management.uninstallSelf
ve management.getSelf
için yönetim izni gerekmez.
Türler
ExtensionDisabledReason
Öğenin devre dışı bırakılmasının bir nedeni.
Enum
"unknown"
ExtensionInfo
Yüklü bir uzantı, uygulama veya tema hakkında bilgiler.
Özellikler
-
appLaunchUrl
string isteğe bağlı
Başlatma URL'si (yalnızca uygulamalar için mevcuttur).
-
availableLaunchTypes
LaunchType[] isteğe bağlı
Şu anda kullanılabilen başlatma türleri (yalnızca uygulamalarda mevcuttur).
-
açıklama
dize
Bu uzantının, uygulamanın veya temanın açıklaması.
-
disabledReason
ExtensionDisabledReason isteğe bağlı
Öğenin devre dışı bırakılmasının bir nedeni.
-
etkin
boolean
Etkin mi yoksa devre dışı mı olduğu.
-
homepageUrl
string isteğe bağlı
Bu uzantının, uygulamanın veya temanın ana sayfasının URL'si.
-
hostPermissions
dize[]
Ana makineye dayalı izinlerin listesini döndürür.
-
simgeler
IconInfo[] isteğe bağlı
Simge bilgilerinin listesi. Bunun yalnızca manifest'te belirtilenleri yansıttığını ve bu URL'deki gerçek resmin, beyan edilenden daha büyük veya daha küçük olabileceğini unutmayın. Bu nedenle, bu resimlere referans veren img etiketlerinde açık genişlik ve yükseklik özellikleri kullanmayı düşünebilirsiniz. Daha fazla bilgi için simgelerle ilgili manifest dokümanlarına bakın.
-
id
dize
Uzantının benzersiz tanımlayıcısı.
-
installType
Uzantının nasıl yüklendiği.
-
isApp
boolean
Kullanımdan kaldırıldıLütfen
management.ExtensionInfo.type
hesabını kullanın.Bu bir uygulamaysa True değerini alır.
-
launchType
LaunchType isteğe bağlı
Uygulama başlatma türü (yalnızca uygulamalar için sunulur).
-
mayDisable
boolean
Bu uzantının kullanıcı tarafından devre dışı bırakılıp bırakılamayacağı veya kaldırılıp kaldırılamayacağı.
-
mayEnable
boole isteğe bağlı
Chrome 62 ve sonraki sürümlerBu uzantının kullanıcı tarafından etkinleştirilip etkinleştirilemeyeceği. Bu değer yalnızca etkin olmayan uzantılar için döndürülür.
-
ad
dize
Bu uzantının, uygulamanın veya temanın adı.
-
offlineEnabled
boolean
Uzantının, uygulamanın veya temanın çevrimdışı erişimi desteklediğini bildirip bildirmediği.
-
optionsUrl
dize
Varsa, öğenin seçenekler sayfasının URL'si.
-
izinler
dize[]
API tabanlı izinlerin listesini döndürür.
-
shortName
dize
Bu uzantı, uygulama veya temanın adının kısa bir sürümü.
-
tür
Bu uzantının, uygulamanın veya temanın türü.
-
updateUrl
string isteğe bağlı
Bu uzantının, uygulamanın veya temanın güncelleme URL'si.
-
sürüm
dize
Bu uzantının, uygulamanın veya temanın sürümü.
-
versionName
string isteğe bağlı
Chrome 50 ve sonraki sürümlerManifestte belirtilmişse bu uzantının, uygulamanın veya temanın sürüm adı.
ExtensionInstallType
Uzantının nasıl yüklendiği. Şunlardan biri:
admin
: Uzantı bir yönetim politikası nedeniyle yüklendi,
development
: Uzantı, geliştirici modunda paketlenmemiş halde yüklenmiş,
normal
: Uzantı bir .crx dosyası aracılığıyla normal şekilde yüklenmiş,
sideload
: Uzantı makinedeki başka bir yazılım tarafından yüklenmiş,
other
: Uzantı başka yollarla yüklenmiş.
Enum
"normal"
ExtensionType
Bu uzantının, uygulamanın veya temanın türü.
Enum
"extension"
"hosted_app"
"packaged_app"
"legacy_packaged_app"
"theme"
"login_screen_extension"
IconInfo
Bir uzantıya, uygulamaya veya temaya ait bir simgeyle ilgili bilgiler.
Özellikler
-
beden
sayı
Simgenin genişliğini ve yüksekliğini temsil eden bir sayı. Olası değerler arasında 128, 48, 24 ve 16 bulunur (ancak bunlarla sınırlı değildir).
-
url
dize
Bu simge resminin URL'si. Simgenin gri tonlamalı sürümünü görüntülemek için (örneğin, bir uzantının devre dışı bırakıldığını belirtmek için) URL'ye
?grayscale=true
ekleyin.
LaunchType
Bunların tümü olası uygulama başlatma türleridir.
Enum
"OPEN_AS_REGULAR_TAB"
"OPEN_AS_PINNED_TAB"
"OPEN_AS_WINDOW"
"OPEN_FULL_SCREEN"
UninstallOptions
Uzantının yüklemesini kaldırma işleminin nasıl yapılacağına ilişkin seçenekler.
Özellikler
-
showConfirmDialog
boole isteğe bağlı
Yüklemeyi kaldırma iletişim kutusunun kullanıcıya istem gösterip göstermeyeceğini belirler. Kendi kendine kaldırma işlemleri için varsayılan olarak false (yanlış) değerine ayarlanır. Bir uzantı, başka bir uzantının yüklemesini kaldırırsa bu parametre yoksayılır ve iletişim kutusu her zaman gösterilir.
Yöntemler
createAppShortcut()
chrome.management.createAppShortcut(
id: string,
callback?: function,
)
Bir uygulama için kısayol oluşturmaya yönelik görüntüleme seçenekleri. Mac'te yalnızca paket uygulama kısayolları oluşturulabilir.
Parametreler
-
id
dize
Bu,
management.ExtensionInfo
uygulama öğesinin kimliği olmalıdır. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
generateAppForLink()
chrome.management.generateAppForLink(
url: string,
title: string,
callback?: function,
)
Bir URL için uygulama oluşturun. Oluşturulan yer işareti uygulamasını döndürür.
Parametreler
-
url
dize
Bir web sayfasının URL'si. URL düzeni yalnızca "http" veya "https" olabilir.
-
title
dize
Oluşturulan uygulamanın başlığı.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: ExtensionInfo) => void
-
sonuç
-
İlerlemeler
-
Promise<ExtensionInfo>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
get()
chrome.management.get(
id: string,
callback?: function,
)
Belirtilen kimliğe sahip yüklü uzantı, uygulama veya tema hakkında bilgi döndürür.
Parametreler
-
id
dize
management.ExtensionInfo
öğesindeki kimlik. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: ExtensionInfo) => void
-
sonuç
-
İlerlemeler
-
Promise<ExtensionInfo>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getAll()
chrome.management.getAll(
callback?: function,
)
Yüklü uzantılar ve uygulamalarla ilgili bilgilerin listesini döndürür.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: ExtensionInfo[]) => void
-
sonuç
-
İlerlemeler
-
Promise<ExtensionInfo[]>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getPermissionWarningsById()
chrome.management.getPermissionWarningsById(
id: string,
callback?: function,
)
Belirli bir uzantı kimliği için izin uyarılarının listesini döndürür.
Parametreler
-
id
dize
Önceden yüklenmiş bir uzantının kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(permissionWarnings: string[]) => void
-
permissionWarnings
dize[]
-
İlerlemeler
-
Söz<dize[]>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getPermissionWarningsByManifest()
chrome.management.getPermissionWarningsByManifest(
manifestStr: string,
callback?: function,
)
Belirli bir uzantı manifest dizesi için izin uyarılarının listesini döndürür. Not: Bu işlev, manifest dosyasında "yönetim" izni istenmeden kullanılabilir.
Parametreler
-
manifestStr
dize
Uzantı manifest JSON dizesi.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(permissionWarnings: string[]) => void
-
permissionWarnings
dize[]
-
İlerlemeler
-
Söz<dize[]>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getSelf()
chrome.management.getSelf(
callback?: function,
)
Telefon uzantısı, uygulama veya tema hakkında bilgi döndürür. Not: Bu işlev, manifest dosyasında "yönetim" izni istenmeden kullanılabilir.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: ExtensionInfo) => void
-
sonuç
-
İlerlemeler
-
Promise<ExtensionInfo>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
installReplacementWebApp()
chrome.management.installReplacementWebApp(
callback?: function,
)
Manifest'te belirtilen değiştirme_web_uygulamasını başlatır. Yüklü değilse kullanıcıdan yüklemesini ister.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
launchApp()
chrome.management.launchApp(
id: string,
callback?: function,
)
Bir uygulamayı başlatır.
Parametreler
-
id
dize
Uygulamanın uzantı kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setEnabled()
chrome.management.setEnabled(
id: string,
enabled: boolean,
callback?: function,
)
Bir uygulamayı veya uzantıyı etkinleştirir ya da devre dışı bırakır. Çoğu durumda bu işlev, kullanıcı hareketi bağlamında çağrılmalıdır (ör. bir düğme için onclick işleyici) ve kötüye kullanımı önlemek üzere kullanıcıya yerel bir onay kullanıcı arayüzü sunabilir.
Parametreler
-
id
dize
Bu,
management.ExtensionInfo
öğesinin bir kimliği olmalıdır. -
etkin
boolean
Bu öğenin etkin mi yoksa devre dışı mı olacağı.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setLaunchType()
chrome.management.setLaunchType(
id: string,
launchType: LaunchType,
callback?: function,
)
Bir uygulamanın başlatma türünü ayarlayın.
Parametreler
-
id
dize
Bu,
management.ExtensionInfo
uygulama öğesinin kimliği olmalıdır. -
launchType
Hedef lansman türü. Kullanılabilir lansman türleri farklı platformlar ve yapılandırmalara göre değiştiğinden her zaman bu lansman türünün
ExtensionInfo.availableLaunchTypes
olduğundan emin olun ve kontrol edin. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
uninstall()
chrome.management.uninstall(
id: string,
options?: UninstallOptions,
callback?: function,
)
Şu anda yüklü bir uygulama veya uzantının yüklemesini kaldırır. Not: Bu işlev, kullanıcının belirtilen uzantıyı/uygulamayı kaldırmasına izin verilmediği yönetilen ortamlarda çalışmaz. Kaldırma işlemi başarısız olursa (ör. kullanıcı, iletişim kutusunu iptal ederse) söz verilen reddedilecek veya geri çağırma runtime.lastError
ayarıyla çağrılır.
Parametreler
-
id
dize
Bu,
management.ExtensionInfo
öğesinin bir kimliği olmalıdır. -
seçenekler
UninstallOptions isteğe bağlı
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
uninstallSelf()
chrome.management.uninstallSelf(
options?: UninstallOptions,
callback?: function,
)
Arama uzantısını kaldırır. Not: Bu işlev, manifest dosyasında "yönetim" izni istenmeden kullanılabilir. Bu işlev, kullanıcının belirtilen uzantıyı/uygulamayı kaldırmasına izin verilmediği yönetilen ortamlarda çalışmaz.
Parametreler
-
seçenekler
UninstallOptions isteğe bağlı
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
Etkinlikler
onDisabled
chrome.management.onDisabled.addListener(
callback: function,
)
Bir uygulama veya uzantı devre dışı bırakıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: ExtensionInfo) => void
-
bilgi
-
onEnabled
chrome.management.onEnabled.addListener(
callback: function,
)
Bir uygulama veya uzantı etkinleştirildiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: ExtensionInfo) => void
-
bilgi
-
onInstalled
chrome.management.onInstalled.addListener(
callback: function,
)
Bir uygulama veya uzantı yüklendiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(info: ExtensionInfo) => void
-
bilgi
-
onUninstalled
chrome.management.onUninstalled.addListener(
callback: function,
)
Bir uygulama veya uzantı kaldırıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(id: string) => void
-
id
dize
-