chrome.management

refresh date: 2026-09-25 robots: noindex

Açıklama

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

İzinler

management

Manifest

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+

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

    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+

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

ExtensionInstallType

Chrome 44+

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+

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+

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

Taahhüt 
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 uygulamasının uygulama öğesindeki kimlik olmalıdır.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Taahhüt 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): 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ığı.

  • callback

    function isteğe bağlı

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

    (result: ExtensionInfo) => void

İadeler

  • Promise<ExtensionInfo>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

get()

Taahhüt 
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+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAll()

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

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

Parametreler

  • callback

    function isteğe bağlı

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

    (result: ExtensionInfo[]) => void

İadeler

  • Promise<ExtensionInfo[]>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getPermissionWarningsById()

Taahhüt 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): 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.

  • callback

    function isteğe bağlı

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

İadeler

  • Promise<string[]>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getPermissionWarningsByManifest()

Taahhüt 
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 "management" izni istenmeden kullanılabilir.

Parametreler

  • manifestStr

    dize

    Uzantı manifesti JSON dizesi.

  • callback

    function isteğe bağlı

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

İadeler

  • Promise<string[]>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getSelf()

Taahhüt 
chrome.management.getSelf(
  callback?: function,
): 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.

Parametreler

  • callback

    function isteğe bağlı

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

    (result: ExtensionInfo) => void

İadeler

  • Promise<ExtensionInfo>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

installReplacementWebApp()

Promise Chrome 77+ 
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

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

launchApp()

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

Bir uygulamayı başlatır.

Parametreler

  • id

    dize

    Uygulamanın uzantı kimliği.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setEnabled()

Taahhüt 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): 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.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

setLaunchType()

Taahhüt 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): 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.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

uninstall()

Taahhüt 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): 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

  • id

    dize

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

  • seçenekler

    UninstallOptions isteğe bağlı

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

uninstallSelf()

Taahhüt 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): 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

  • seçenekler

    UninstallOptions isteğe bağlı

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 88+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması 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

  • callback

    işlev

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

    (id: string) => void

    • id

      dize