browser.management

Açıklama

chrome.management API'si, yüklü uygulamaları ve uzantıları yönetmenin yollarını sunar.

İzinler

management

Management API'yi kullanmak için uzantı manifest dosyasında "management" 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 Chrome 148'den itibaren browser.*

Öğenin devre dışı bırakılma nedeni.

Enum

"unknown"

"permissions_increase"

ExtensionInfo

Yüklü bir uzantı, uygulama veya tema hakkında bilgi.

Ö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 uygulamalar için geçerlidir).

  • açıklama

    dize

    Bu uzantı, uygulama veya temanın açıklaması.

  • disabledReason

    ExtensionDisabledReason isteğe bağlı

    Öğenin devre dışı bırakılma nedeni.

  • etkin

    boole

    Şu anda etkin veya devre dışı olup olmadığı.

  • homepageUrl

    string isteğe bağlı

    Bu uzantı, uygulama veya temanın ana sayfasının URL'si.

  • hostPermissions

    string[]

    Ana makine tabanlı izinlerin listesini döndürür.

  • simgeler

    IconInfo[] isteğe bağlı

    Simge bilgilerinin listesi. Bunun yalnızca manifestte beyan edilenleri yansıttığını ve ilgili 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 belgelerini inceleyin.

  • id

    dize

    Uzantının benzersiz tanımlayıcısı.

  • installType

    ExtensionInstallType

    Uzantının nasıl yüklendiği.

  • isApp

    boole

    Kullanımdan kaldırıldı

    Lütfen management.ExtensionInfo.type kullanın.

    Bu bir uygulamaysa doğru değerini alır.

  • launchType

    LaunchType isteğe bağlı

    Uygulama başlatma türü (yalnızca uygulamalar için geçerlidir).

  • mayDisable

    boole

    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 Chrome 148'den itibaren browser.*

    Bu uzantının kullanıcı tarafından etkinleştirilip etkinleştirilemeyeceği. Bu, yalnızca etkinleştirilmemiş uzantılar için döndürülür.

  • ad

    dize

    Bu uzantı, uygulama veya temanın adı.

  • offlineEnabled

    boole

    Uzantı, uygulama veya temanın çevrimdışı kullanımı desteklediğini beyan edip etmediği.

  • optionsUrl

    dize

    Öğenin seçenekler sayfasının URL'si (varsa).

  • izinler

    string[]

    API tabanlı izinlerin listesini döndürür.

  • shortName

    dize

    Bu uzantı, uygulama veya temanın adının kısa bir versiyonu.

  • Bu uzantı, uygulama veya temanın türü.

  • updateUrl

    string isteğe bağlı

    Bu uzantı, uygulama 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 Chrome 148'den itibaren browser.*

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

ExtensionInstallType

Chrome 44 ve sonraki sürümler Chrome 148'den itibaren browser.*

Uzantının nasıl yüklendiği. admin: Uzantı, bir yönetim politikası nedeniyle yüklendi, development: Uzantı, geliştirici modunda paketi açılmış olarak yüklendi, normal: Uzantı, bir .crx dosyası aracılığıyla normal şekilde yüklendi, sideload: Uzantı, makinedeki başka bir yazılım tarafından yüklendi, other: Uzantı, başka yöntemlerle yüklendi.

Enum

"admin"

"development"

"normal"

"sideload"

"diğer"

ExtensionType

Chrome 44 ve sonraki sürümler Chrome 148'den itibaren browser.*

Bu uzantı, uygulama veya temanın türü.

Enum

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

Bir uzantı, uygulama veya temaya ait 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ı bir 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, olası tüm 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 Chrome 148'den itibaren browser.*

Uzantının kaldırılmasıyla ilgili seçenekler.

Özellikler

  • showConfirmDialog

    boole isteğe bağlı

    Kullanıcıya kaldırma işlemini onaylama iletişim kutusunun gösterilip gösterilmeyeceği. Kendi kendine kaldırma işlemleri için varsayılan olarak false değerini alır. Bir uzantı başka bir uzantıyı kaldırırsa bu parametre yoksayılır ve iletişim kutusu her zaman gösterilir.

Yöntemler

createAppShortcut()

browser.management.createAppShortcut(
  id: string,
): Promise<void>

Bir uygulama için kısayol oluşturma seçeneklerini gösterir. Mac'te yalnızca paketlenmiş uygulama kısayolları oluşturulabilir.

Parametreler

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.* 
browser.management.generateAppForLink(
  url: string,
  title: string,
): Promise<ExtensionInfo>

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 şeması yalnızca "http" veya "https" olabilir.

  • title

    dize

    Oluşturulan uygulamanın başlığı.

İadeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

get()

browser.management.get(
  id: string,
): Promise<ExtensionInfo>

Belirtilen kimliğe sahip yüklü uzantı, uygulama veya tema hakkında bilgi döndürür.

Parametreler

İadeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

getAll()

browser.management.getAll(): Promise<ExtensionInfo[]>

Yüklü uzantılar ve uygulamalar hakkında bilgi listesi döndürür.

İadeler

  • Promise<ExtensionInfo[]>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

getPermissionWarningsById()

browser.management.getPermissionWarningsById(
  id: string,
): Promise<string[]>

Belirli bir uzantı kimliği için izin uyarılarının listesini döndürür.

Parametreler

  • id

    dize

    Yüklü bir uzantının kimliği.

İadeler

  • Promise<string[]>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

getPermissionWarningsByManifest()

browser.management.getPermissionWarningsByManifest(
  manifestStr: string,
): Promise<string[]>

Belirli bir uzantı manifest dizesi için izin uyarılarının listesini döndürür. Not: Bu işlev, manifest dosyasında "management" izni istenmeden kullanılabilir.

Parametreler

  • manifestStr

    dize

    Uzantı manifesti JSON dizesi.

İadeler

  • Promise<string[]>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

getSelf()

browser.management.getSelf(): Promise<ExtensionInfo>

Çağrıyı yapan uzantı, uygulama veya tema hakkında bilgi döndürür. Not: Bu işlev, manifest dosyasında "management" izni istenmeden kullanılabilir.

İadeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

installReplacementWebApp()

Chrome 77 ve sonraki sürümler Chrome 148'den itibaren browser.* 
browser.management.installReplacementWebApp(): Promise<void>

Manifest dosyasında belirtilen replacement_web_app'i başlatır. Yüklü değilse kullanıcıdan yüklemesini ister.

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

launchApp()

browser.management.launchApp(
  id: string,
): Promise<void>

Bir uygulamayı başlatır.

Parametreler

  • id

    dize

    Uygulamanın uzantı kimliği.

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

setEnabled()

browser.management.setEnabled(
  id: string,
  enabled: boolean,
): Promise<void>

Bir uygulamayı veya uzantıyı etkinleştirir ya da devre dışı bırakır. Çoğu durumda bu işlev, bir kullanıcı hareketinin (ör. bir düğmenin onclick işleyicisi) bağlamında çağrılmalıdır ve kötüye kullanımı önlemek için kullanıcıya yerel bir onay kullanıcı arayüzü sunabilir.

Parametreler

  • id

    dize

    Bu, management.ExtensionInfo öğesinin kimliği olmalıdır.

  • etkin

    boole

    Bu öğenin etkinleştirilip etkinleştirilmeyeceği.

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

setLaunchType()

browser.management.setLaunchType(
  id: string,
  launchType: LaunchType,
): Promise<void>

Uygulamanın başlatma türünü ayarlayın.

Parametreler

  • id

    dize

    Bu, management.ExtensionInfo uygulamasının uygulama öğesindeki kimlik olmalıdır.

  • launchType

    LaunchType

    Hedef başlatma türü. Kullanılabilir başlatma türleri farklı platformlarda ve yapılandırmalarda değişiklik gösterdiğinden, bu başlatma türünün ExtensionInfo.availableLaunchTypes içinde olduğunu her zaman kontrol edin ve emin olun.

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

uninstall()

browser.management.uninstall(
  id: string,
  options?: UninstallOptions,
): Promise<void>

Yüklü olan bir uygulama veya uzantıyı kaldırır. Not: Bu işlev, kullanıcının belirtilen uzantıyı/uygulamayı kaldırmasına izin verilmeyen yönetilen ortamlarda çalışmaz. Kaldırma işlemi başarısız olursa (ör. kullanıcı iletişim kutusunu iptal ederse) promise reddedilir veya geri çağırma, runtime.lastError ayarlanarak çağrılır.

Parametreler

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

uninstallSelf()

browser.management.uninstallSelf(
  options?: UninstallOptions,
): Promise<void>

Arama uzantısını kaldırır. Not: Bu işlev, manifest dosyasında "management" izni istenmeden kullanılabilir. Bu işlev, kullanıcının belirtilen uzantıyı/uygulamayı kaldırmasına izin verilmeyen yönetilen ortamlarda çalışmaz.

Parametreler

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler Chrome 148'den itibaren browser.*

Etkinlikler

onDisabled

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

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

Parametreler

onEnabled

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

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

Parametreler

onInstalled

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

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

Parametreler

onUninstalled

browser.management.onUninstalled.addListener(
  callback: function,
)

Bir uygulama veya uzantı kaldırıldığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (id: string) => void

    • id

      dize