chrome.management

Deskripsi

chrome.management API menyediakan cara untuk mengelola aplikasi dan ekstensi terinstal.

Izin

management

Anda harus menyatakan izin "pengelolaan" izin di manifes ekstensi untuk menggunakan opsi pengelolaan Compute Engine API. Contoh:

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

management.getPermissionWarningsByManifest(), management.uninstallSelf(), dan management.getSelf() tidak memerlukan izin pengelolaan.

Jenis

ExtensionDisabledReason

Chrome 44 dan yang lebih baru

Alasan item tersebut dinonaktifkan.

Enum

"tidak diketahui"

"permissions_increase"

ExtensionInfo

Informasi tentang ekstensi, aplikasi, atau tema yang diinstal.

Properti

  • appLaunchUrl

    string opsional

    URL peluncuran (hanya ada untuk aplikasi).

  • availableLaunchTypes

    LaunchType[] opsional

    Jenis peluncuran yang saat ini tersedia (hanya ada untuk aplikasi).

  • deskripsi

    string

    Deskripsi ekstensi, aplikasi, atau tema ini.

  • disabledReason

    ExtensionDisabledReason opsional

    Alasan item tersebut dinonaktifkan.

  • diaktifkan

    boolean

    Apakah saat ini diaktifkan atau dinonaktifkan.

  • homepageUrl

    string opsional

    URL halaman beranda ekstensi, aplikasi, atau tema ini.

  • hostPermissions

    {i>string<i}[]

    Menampilkan daftar izin berbasis host.

  • ikon

    IconInfo[] opsional

    Daftar informasi ikon. Perhatikan bahwa ini hanya mencerminkan apa yang dideklarasikan dalam manifes, dan gambar sebenarnya pada URL tersebut mungkin lebih besar atau lebih kecil daripada yang dideklarasikan, sehingga Anda dapat mempertimbangkan untuk menggunakan atribut lebar dan tinggi eksplisit pada tag img yang merujuk pada gambar ini. Lihat dokumentasi manifes tentang ikon untuk detail selengkapnya.

  • id

    string

    ID unik ekstensi.

  • installType

    ExtensionInstallType

    Cara ekstensi diinstal.

  • isApp

    boolean

    Tidak digunakan lagi

    Harap gunakan management.ExtensionInfo.type.

    Benar jika ini adalah aplikasi.

  • launchType

    LaunchType opsional

    Jenis peluncuran aplikasi (hanya ada untuk aplikasi).

  • mayDisable

    boolean

    Apakah ekstensi ini dapat dinonaktifkan atau di-uninstal oleh pengguna.

  • mayEnable

    boolean opsional

    Chrome 62 dan yang lebih baru

    Apakah ekstensi ini dapat diaktifkan oleh pengguna atau tidak. Kolom ini hanya ditampilkan untuk ekstensi yang tidak diaktifkan.

  • nama

    string

    Nama ekstensi, aplikasi, atau tema ini.

  • offlineEnabled

    boolean

    Apakah ekstensi, aplikasi, atau tema mendeklarasikan bahwa ekstensi, aplikasi, atau tema mendukung offline.

  • optionsUrl

    string

    URL untuk halaman opsi item, jika ada.

  • izin

    {i>string<i}[]

    Menampilkan daftar izin berbasis API.

  • namasingkat

    string

    Versi singkat dari nama ekstensi, aplikasi, atau tema ini.

  • Jenis ekstensi, aplikasi, atau tema ini.

  • updateUrl

    string opsional

    URL update ekstensi, aplikasi, atau tema ini.

  • versi

    string

    Versi ekstensi, aplikasi, atau tema ini.

  • versionName

    string opsional

    Chrome 50 dan yang lebih baru

    Nama versi ekstensi, aplikasi, atau tema ini jika manifes menentukannya.

ExtensionInstallType

Chrome 44 dan yang lebih baru

Cara ekstensi diinstal. Salah satu admin: Ekstensi diinstal karena kebijakan administratif, development: Ekstensi dimuat dan diekstrak dalam mode developer, normal: Ekstensi diinstal secara normal melalui file .crx, sideload: Ekstensi diinstal oleh software lain di komputer, other: Ekstensi diinstal dengan cara lain.

Enum

"admin"

"pengembangan"

"normal"

"sideload"

"lainnya"

ExtensionType

Chrome 44 dan yang lebih baru

Jenis ekstensi, aplikasi, atau tema ini.

Enum

"ekstensi"

"aplikasi_dihosting"

&quot;packaged_app&quot;

&quot;legacy_packaged_app&quot;

"theme"

&quot;login_screen_extension&quot;

IconInfo

Informasi tentang ikon milik ekstensi, aplikasi, atau tema.

Properti

  • ukuran

    angka

    Angka yang mewakili lebar dan tinggi ikon. Nilai yang mungkin mencakup (tetapi tidak terbatas pada) 128, 48, 24, dan 16.

  • url

    string

    URL untuk gambar ikon ini. Untuk menampilkan versi ikon hitam putih (misalnya untuk menunjukkan bahwa ekstensi dinonaktifkan), tambahkan ?grayscale=true ke URL.

LaunchType

Ini semua adalah jenis peluncuran aplikasi yang mungkin.

Enum

&quot;OPEN_AS_REGULAR_TAB&quot;

&quot;OPEN_AS_PINNED_TAB&quot;

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 dan yang lebih baru

Opsi tentang cara menangani uninstal ekstensi.

Properti

  • showConfirmDialog

    boolean opsional

    Apakah dialog konfirmasi-uninstal akan meminta pengguna atau tidak. Nilai defaultnya adalah false untuk uninstal mandiri. Jika sebuah ekstensi meng-uninstal ekstensi lain, parameter ini akan diabaikan dan dialog akan selalu ditampilkan.

Metode

createAppShortcut()

Janji 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
)

Menampilkan opsi untuk membuat pintasan sebuah aplikasi. Di Mac, hanya pintasan aplikasi terpaket yang dapat dibuat.

Parameter

  • id

    string

    ID ini harus berupa ID dari item aplikasi management.ExtensionInfo.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Janji 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
)

Buat aplikasi untuk URL. Menampilkan aplikasi bookmark yang dihasilkan.

Parameter

  • url

    string

    URL halaman web. Skema URL hanya boleh "http" atau "https".

  • judul

    string

    Judul aplikasi yang dibuat.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (result: ExtensionInfo) => void

Hasil

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

get()

Janji 
chrome.management.get(
  id: string,
  callback?: function,
)

Menampilkan informasi tentang ekstensi, aplikasi, atau tema yang diinstal yang memiliki ID yang diberikan.

Parameter

Hasil

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getAll()

Janji 
chrome.management.getAll(
  callback?: function,
)

Menampilkan daftar informasi tentang ekstensi dan aplikasi yang diinstal.

Parameter

Hasil

  • Promise&lt;ExtensionInfo[]&gt;

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getPermissionWarningsById()

Janji 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
)

Menampilkan daftar peringatan izin untuk ID ekstensi yang diberikan.

Parameter

  • id

    string

    ID ekstensi yang sudah diinstal.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      {i>string<i}[]

Hasil

  • Promise&lt;string[]&gt;

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getPermissionWarningsByManifest()

Janji 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
)

Menampilkan daftar peringatan izin untuk string manifes ekstensi yang diberikan. Perhatikan: Fungsi ini dapat digunakan tanpa meminta izin 'pengelolaan' dalam manifes.

Parameter

  • manifestStr

    string

    String JSON manifes ekstensi.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      {i>string<i}[]

Hasil

  • Promise&lt;string[]&gt;

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getSelf()

Janji 
chrome.management.getSelf(
  callback?: function,
)

Menampilkan informasi tentang ekstensi, aplikasi, atau tema panggilan. Perhatikan: Fungsi ini dapat digunakan tanpa meminta izin 'pengelolaan' dalam manifes.

Parameter

Hasil

  • Promise&lt;ExtensionInfo&gt;

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

installReplacementWebApp()

Janji Chrome 77 dan yang lebih baru 
chrome.management.installReplacementWebApp(
  callback?: function,
)

Meluncurkan replace_web_app yang ditentukan dalam manifes. Meminta pengguna untuk menginstal jika belum diinstal.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

launchApp()

Janji 
chrome.management.launchApp(
  id: string,
  callback?: function,
)

Meluncurkan aplikasi.

Parameter

  • id

    string

    ID ekstensi aplikasi.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setEnabled()

Janji 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
)

Mengaktifkan atau menonaktifkan aplikasi atau ekstensi. Umumnya, fungsi ini harus dipanggil dalam konteks gestur pengguna (misalnya, pengendali onclick untuk tombol), dan dapat menampilkan UI konfirmasi native kepada pengguna sebagai cara untuk mencegah penyalahgunaan.

Parameter

  • id

    string

    ID ini harus berupa ID dari item management.ExtensionInfo.

  • diaktifkan

    boolean

    Apakah item ini harus diaktifkan atau dinonaktifkan.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setLaunchType()

Janji 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
)

Menetapkan jenis peluncuran aplikasi.

Parameter

  • id

    string

    ID ini harus berupa ID dari item aplikasi management.ExtensionInfo.

  • launchType

    LaunchType

    Jenis peluncuran target. Selalu periksa dan pastikan jenis peluncuran ini menggunakan ExtensionInfo.availableLaunchTypes, karena jenis peluncuran yang tersedia bervariasi di berbagai platform dan konfigurasi.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

uninstall()

Janji 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
)

Meng-uninstal aplikasi atau ekstensi yang terinstal saat ini. Catatan: Fungsi ini tidak berfungsi di lingkungan terkelola jika pengguna tidak diizinkan untuk meng-uninstal ekstensi/aplikasi yang ditentukan. Jika uninstal gagal (misalnya, pengguna membatalkan dialog), promise akan ditolak atau callback akan dipanggil dengan menetapkan runtime.lastError.

Parameter

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

uninstallSelf()

Janji 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
)

Meng-uninstal ekstensi panggilan. Perhatikan: Fungsi ini dapat digunakan tanpa meminta izin 'pengelolaan' dalam manifes. Fungsi ini tidak berfungsi di lingkungan terkelola jika pengguna tidak diizinkan untuk meng-uninstal ekstensi/aplikasi yang ditentukan.

Parameter

  • opsi

    UninstallOptions opsional

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    () => void

Hasil

  • Janji<void>

    Chrome 88 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onDisabled

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

Diaktifkan saat aplikasi atau ekstensi telah dinonaktifkan.

Parameter

onEnabled

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

Diaktifkan saat aplikasi atau ekstensi telah diaktifkan.

Parameter

onInstalled

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

Diaktifkan saat aplikasi atau ekstensi telah diinstal.

Parameter

onUninstalled

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

Diaktifkan saat aplikasi atau ekstensi telah di-uninstal.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (id: string) => void

    • id

      string