chrome.management

refresh date: 2026-09-25 robots: noindex

Açıklama

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

İzinler

management

Manifest

Yönetim API'sini kullanmak için uzantı manifestinde "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

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

Enum

"unknown"

"permissions_increase"

ExtensionInfo

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

Özellikler

  • appLaunchUrl

    dize isteğe bağlı

    Başlatma 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ının, uygulamanın veya temanın açıklaması.

  • disabledReason

    ExtensionDisabledReason isteğe bağlı

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

  • etkin

    boole

    Ş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

    string[]

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

  • simgeler

    IconInfo[] isteğe bağlı

    Simge bilgilerinin listesi. Bu durumun yalnızca manifestte belirtilenleri yansıttığını ve söz konusu URL'deki gerçek resmin belirtilenden daha büyük veya küçük olabileceğini unutmayın. Bu nedenle, bu resimlere referans veren img etiketlerinde açık genişlik ve yükseklik özelliklerini 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

    boolean isteğe bağlı

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

  • offlineEnabled

    boole

    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

    string[]

    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ının, uygulamanın veya temanın türü.

  • updateUrl

    dize 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

    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 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ş 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"

"diğer"

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

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 128, 48, 24 ve 16'dır (ancak bunlarla sınırlı değildir).

  • url

    dize

    Bu simge resminin URL'si. Simgenin gri tonlamalı bir sürümünü göstermek 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 şekliyle 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 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()

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 paket uygulaması kısayolları oluşturulabilir.

Parametreler

  • id

    dize

    Bu, management.ExtensionInfo uygulamasının öğe kimliği 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şturma Oluşturulan yer işareti uygulamasını döndürür.

Parametreler

  • url

    dize

    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 uygulamalarla ilgili 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[]>

Belirli bir 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

      string[]

İ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

      string[]

İ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>

Arayan uzantı, uygulama veya tema 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. Çoğu durumda bu işlev, kullanıcı hareketi bağlamında (ör. bir düğme için onclick işleyicisi) ç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

    boole

    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>

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

Parametreler

  • id

    dize

    Bu, management.ExtensionInfo uygulamasının öğe kimliği 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 içinde 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 uygulamayı 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) 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ının/uygulamanın yüklemesini 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 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