chrome.management

Açıklama

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

İzinler

management

Manifest

"Yönetim"i beyan etmeniz gerekir. yönetimi kullanmak için uzantı manifestinde API'ye gidin. Örneğin:

{
  "name": "My extension",
  ...
  "permissions": [
    "management"
  ],
  ...
}

management.getPermissionWarningsByManifest, management.uninstallSelf ve management.getSelf yönetim izni gerektirmez.

Türler

ExtensionDisabledReason

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Öğenin devre dışı bırakılmasının bir nedeni.

Enum

"unknown"

"permissions_increase"

ExtensionInfo

Yüklü bir uzantı, uygulama veya temayla ilgili bilgiler.

Özellikler

  • appLaunchUrl

    dize 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 mevcuttur).

  • açıklama

    dize

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

  • disabledReason

    ExtensionDisabledReason isteğe bağlı

    Öğenin devre dışı bırakılmasının bir nedeni.

  • etkin

    boolean

    Etkin veya devre dışı olup olmadığı.

  • homepageUrl

    dize isteğe bağlı

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

  • hostPermissions

    dize[]

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

  • simgeler

    IconInfo[] isteğe bağlı

    Simge bilgilerinin listesi. Bunun yalnızca manifest'te beyan edilen içeriği yansıttığını ve söz konusu URL'deki gerçek resmin bildirilenden 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

    Desteği sonlandırıldı

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

    Bu bir uygulamaysa doğru değerini döndürür.

  • launchType

    LaunchType isteğe bağlı

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

  • mayDisable

    boolean

    Bu uzantının kullanıcı tarafından devre dışı bırakılıp kaldırılamayacağı veya kaldırılıp kaldırılamayacağı.

  • mayEnable

    boole isteğe bağlı

    Chrome 62 ve sonraki sürümler 'nı inceleyin.

    Bu uzantının kullanıcı tarafından etkinleştirilip etkinleştirilmeyeceği. Bu hata yalnızca etkin olmayan uzantılar için döndürülür.

  • ad

    dize

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

  • offlineEnabled

    boolean

    Uzantının, uygulamanın veya temanın çevrimdışı erişimi desteklediğini beyan edip etmediği.

  • optionsUrl

    dize

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

  • izinler

    dize[]

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

  • kısaAd

    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

    dize isteğe bağlı

    Bu uzantı, uygulama veya temanın güncelleme URL'si.

  • sürüm

    dize

    Bu uzantı, uygulama veya temanın sürümü.

  • versionName

    dize isteğe bağlı

    Chrome 50 ve sonraki sürümler 'nı inceleyin.

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

ExtensionInstallType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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üklendi. normal: Uzantı, .crx dosyasıyla normal bir şekilde yüklendi. sideload: Uzantı, makinedeki başka bir yazılım tarafından yüklenmiştir. other: Uzantı başka yollarla yüklenmiş.

Enum

"admin"

"geliştirme"

"normal"

"sideload"

"diğer"

ExtensionType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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

Enum

"uzantı"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

Bir uzantı, uygulama veya temaya ait simge hakkında bilgiler.

Özellikler

  • beden

    sayı

    Simgenin genişliğini ve yüksekliğini temsil eden bir sayıdır. Olası değerler 128, 48, 24 ve 16'yı içerir (ancak bunlarla sınırlı değildir).

  • url

    dize

    Bu simge resminin URL'si. Simgenin gri tonlamalı sürümünü göstermek için (örneğin, bir uzantının devre dışı bırakıldığını belirtmek amacıyla) 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 'nı inceleyin.

Uzantının yüklemesini kaldırma işleminin nasıl gerçekleştirileceğine ilişkin seçenekler.

Özellikler

  • showConfirmDialog

    boole isteğe bağlı

    Yüklemeyi kaldırma işlemini onaylama 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 değerine ayarlanır. Bir uzantı başka bir uzantıyı kaldırırsa bu parametre yok sayılır ve iletişim kutusu her zaman gösterilir.

Yöntemler

createAppShortcut()

Söz 'nı inceleyin.
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

Uygulama için kısayol oluşturma seçeneklerini görüntüleyin. Mac'te yalnızca paket uygulama kısayolları oluşturulabilir.

Parametreler

  • id

    dize

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Söz 'nı inceleyin.
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

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" olabilir veya "https".

  • title

    dize

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

  • geri çağırma

    işlev isteğe bağlı

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

    (result: ExtensionInfo) => void

İadeler

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

get()

Söz 'nı inceleyin.
chrome.management.get(
  id: string,
  callback?: function,
)

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

Parametreler

İadeler

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getAll()

Söz 'nı inceleyin.
chrome.management.getAll(
  callback?: function,
)

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (result: ExtensionInfo[]) => void

İadeler

  • Promise&lt;ExtensionInfo[]&gt;

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getPermissionWarningsById()

Söz 'nı inceleyin.
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

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

Parametreler

  • id

    dize

    Zaten yüklü bir uzantının kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      dize[]

İadeler

  • Promise&lt;string[]&gt;

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getPermissionWarningsByManifest()

Söz 'nı inceleyin.
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

Belirli bir uzantı manifest dizesi için izin uyarıları listesini döndürür. Not: Bu işlev, "yönetim" istenmeden kullanılabilir izninin olması gerekir.

Parametreler

  • manifestStr

    dize

    Uzantı manifest JSON dizesi.

  • geri çağırma

    işlev isteğe bağlı

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      dize[]

İadeler

  • Promise&lt;string[]&gt;

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getSelf()

Söz 'nı inceleyin.
chrome.management.getSelf(
  callback?: function,
)

Arama uzantısı, uygulaması veya teması hakkında bilgi döndürür. Not: Bu işlev, "yönetim" istenmeden kullanılabilir izninin olması gerekir.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (result: ExtensionInfo) => void

İadeler

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

installReplacementWebApp()

Söz Chrome 77 ve sonraki sürümler 
chrome.management.installReplacementWebApp(
  callback?: function,
)

Manifest'te belirtilen replace_web_app değerini başlatır. Yüklü değilse kullanıcıdan yüklemesini ister.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

launchApp()

Söz 'nı inceleyin.
chrome.management.launchApp(
  id: string,
  callback?: function,
)

Bir uygulama başlatır.

Parametreler

  • id

    dize

    Uygulamanın uzantı kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setEnabled()

Söz 'nı inceleyin.
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, bir kullanıcı hareketi bağlamında çağrılmalıdır (ör. bir düğme için tıklama işleyici) 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 öğesindeki kimlik olmalıdır.

  • etkin

    boolean

    Bu öğenin etkin mi yoksa devre dışı mı olması gerektiği.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setLaunchType()

Söz 'nı inceleyin.
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

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

Parametreler

  • id

    dize

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

  • launchType

    LaunchType

    Hedef başlatma türü. Kullanılabilen lansman türleri farklı platformlara ve yapılandırmalara göre değişiklik gösterdiği için bu lansman türünün ExtensionInfo.availableLaunchTypes olarak sunulduğundan emin olun.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

uninstall()

Söz 'nı inceleyin.
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

Yüklü bir uygulamayı veya uzantıyı 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) taahhüt reddedilir veya geri çağırma, runtime.lastError ayarlanmış olarak çağrılır.

Parametreler

  • id

    dize

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

  • seçenekler

    UninstallOptions isteğe bağlı

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

uninstallSelf()

Söz 'nı inceleyin.
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

Arama uzantısını kaldırır. Not: Bu işlev, "yönetim" istenmeden kullanılabilir izninin olması gerekir. 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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

    Chrome 88 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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