chrome.management

Açıklama

chrome.management API, yüklü uygulamaları ve uzantıları yönetme yöntemleri sunar.

İzinler

management

Manifest

Management API'yi kullanmak için uzantı manifestinde "management" iznini belirtmeniz 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 veya daha yeni bir sürüm

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

Enum

"unknown"

"permissions_increase"

ExtensionInfo

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

Özellikler

  • appLaunchUrl

    dize isteğe bağlı

    Lansman URL'si (yalnızca uygulamalar için geçerlidir).

  • availableLaunchTypes

    LaunchType[] isteğe bağlı

    Şu anda kullanılabilen lansman 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

    boolean

    Şu anda etkin mi yoksa devre dışı mı olduğu.

  • homepageUrl

    dize isteğe bağlı

    Bu uzantının, uygulamanın 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. Bu yalnızca manifestte belirtilenleri yansıtır ve söz konusu URL'deki gerçek resim, belirtilenden daha büyük veya daha küçük olabilir. Bu nedenle, bu resimlere referans veren img etiketlerinde açık genişlik ve yükseklik özellikleri kullanmayı düşünebilirsiniz. Daha fazla ayrıntı için ikonlarla ilgili manifest dokümanlarını inceleyin.

  • 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 kullanın.

    Uygulama ise doğru.

  • 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 bırakılamayacağı veya kaldırılıp kaldırılamayacağı.

  • mayEnable

    boolean isteğe bağlı

    Chrome 62 veya daha yeni bir sürüm

    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ının, uygulamanın veya temanın adı.

  • offlineEnabled

    boolean

    Uzantı, uygulama veya temanın çevrimdışı desteği olduğunu belirtip belirtmediği.

  • optionsUrl

    dize

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

  • izinler

    dize[]

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

  • shortName

    dize

    Bu uzantının, uygulamanın veya temanın adının kısa bir sürümü.

  • Bu uzantı, uygulama 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ının, uygulamanın veya temanın sürümü.

  • versionName

    dize isteğe bağlı

    Chrome 50 veya daha yeni bir sürüm

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

ExtensionInstallType

Chrome 44 veya daha yeni bir sürüm

Uzantının nasıl yüklendiği. Şunlardan biri: admin: Uzantı, yönetim politikası nedeniyle yüklendi, development: Uzantı, geliştirici modunda paketlenmemiş olarak yüklendi, normal: Uzantı, .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 bir yöntemle yüklendi.

Enum

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

Chrome 44 veya daha yeni bir sürüm

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

Enum

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

Uzantı, uygulama 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ı bir sürümünü görüntülemek için (örneğin, bir uzantının devre dışı olduğunu 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

Uzantının kaldırılma işleminin nasıl ele alınacağıyla ilgili seçenekler.

Özellikler

  • showConfirmDialog

    boolean isteğe bağlı

    Kullanıcıya kaldırma işlemini onaylama iletişim kutusu gösterilip gösterilmeyeceği. Kullanıcı tarafından kaldırılan uygulamalar için varsayılan değer false'tur. 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()

Promise 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): 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

  • id

    dize

    Bu, management.ExtensionInfo öğesinin uygulama öğesinden alınan kimlik olmalıdır.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Promise 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

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

  • title

    dize

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

  • callback

    işlev isteğe bağlı

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

    (result: ExtensionInfo) => void

İadeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

get()

Promise 
chrome.management.get(
  id: string,
  callback?: function,
): 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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getAll()

Promise 
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    (result: ExtensionInfo[]) => void

İadeler

  • Promise<ExtensionInfo[]>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getPermissionWarningsById()

Promise 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

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

Parametreler

  • id

    dize

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

  • callback

    işlev isteğe bağlı

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      dize[]

İadeler

  • Promise<string[]>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getPermissionWarningsByManifest()

Promise 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): 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 "yönetim" izni istenmeden kullanılabilir.

Parametreler

  • manifestStr

    dize

    Uzantı manifesti JSON dizesi.

  • callback

    işlev isteğe bağlı

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      dize[]

İadeler

  • Promise<string[]>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getSelf()

Promise 
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    (result: ExtensionInfo) => void

İadeler

  • Promise<ExtensionInfo>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

installReplacementWebApp()

Promise Chrome 77 ve sonraki sürümler 
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

launchApp()

Promise 
chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

Bir uygulamayı başlatır.

Parametreler

  • id

    dize

    Uygulamanın uzantı kimliği.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setEnabled()

Promise 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

Uygulamaları veya uzantıları etkinleştirir ya da devre dışı bırakır. Bu işlev çoğu durumda bir kullanıcı hareketi (ör. bir düğme için 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ü gösterebilir.

Parametreler

  • id

    dize

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

  • etkin

    boolean

    Bu öğenin etkinleştirilip devre dışı bırakılmayacağı.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setLaunchType()

Promise 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

Bir uygulamanın lansman türünü ayarlayın.

Parametreler

  • id

    dize

    Bu, management.ExtensionInfo öğesinin uygulama öğesinden alınan kimlik olmalıdır.

  • launchType

    LaunchType

    Hedef lansman türü. Kullanılabilir lansman türleri farklı platformlarda ve yapılandırmalarda değişiklik gösterdiğinden, bu lansman türünün her zaman ExtensionInfo.availableLaunchTypes olduğundan emin olun.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

uninstall()

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

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

Parametreler

  • id

    dize

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

  • seçenekler

    UninstallOptions isteğe bağlı

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

uninstallSelf()

Promise 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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ı

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

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 uygulamanın veya uzantının yüklemesi kaldırıldığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (id: string) => void

    • id

      dize