chrome.management

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

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

Chrome 44 ve sonraki sürümler

Öğ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

    ExtensionInstallType

    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ümler

    Bu 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ü.

  • 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ümler

    Manifestte belirtilmişse bu uzantının, uygulamanın veya temanın sürüm adı.

ExtensionInstallType

Chrome 44 ve sonraki sürümler

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

Chrome 44 ve sonraki sürümler

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

Chrome 88 ve sonraki sürümler

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

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Söz 
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

İlerlemeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

get()

Söz 
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

İlerlemeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getAll()

Söz 
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

İlerlemeler

  • Promise<ExtensionInfo[]>

    Chrome 88 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getPermissionWarningsById()

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getPermissionWarningsByManifest()

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getSelf()

Söz 
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

İlerlemeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

installReplacementWebApp()

Söz Chrome 77 ve sonraki sürümler 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

launchApp()

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setEnabled()

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setLaunchType()

Söz 
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

    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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

uninstall()

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

uninstallSelf()

Söz 
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ümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

Bir uygulama veya uzantı devre dışı bırakıldığında tetiklenir.

Parametreler

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

Bir uygulama veya uzantı etkinleştirildiğinde tetiklenir.

Parametreler

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

Bir uygulama veya uzantı yüklendiğinde tetiklenir.

Parametreler

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