chrome.app.runtime

Deskripsi

Gunakan chrome.app.runtime API untuk mengelola siklus proses aplikasi. Runtime aplikasi mengelola penginstalan aplikasi, mengontrol halaman peristiwa, dan dapat menonaktifkan aplikasi kapan saja.

Jenis

ActionData

Chrome 54+

Properti

  • actionType

    "new_note"

ActionType

Chrome 54+

Aplikasi dapat diluncurkan dengan mempertimbangkan tindakan tertentu, misalnya, untuk membuat catatan baru. Jenis tindakan yang digunakan untuk meluncurkan aplikasi tersedia di dalam kolom actionData dari instance LaunchData.

Nilai

EmbedRequest

Properti

  • data

    semua opsional

    Data opsional yang ditentukan developer, yang dapat digunakan oleh aplikasi yang akan disematkan, saat membuat keputusan penyematan.

  • embedderId

    string

  • izinkan

    void

    Mengizinkan embedderId menyematkan aplikasi ini di <appview> . url menentukan konten yang akan disematkan.

    Fungsi allow akan terlihat seperti ini: 

    (url: string) => {...}

    • url

      string

  • tolak

    void

    Mencegah embedderId menyematkan aplikasi ini di <appview> .

    Fungsi deny akan terlihat seperti ini: 

    () => {...}

LaunchData

Properti

  • actionData

    ActionData opsional

    Chrome 54 dan yang lebih baru

    Berisi data yang menentukan ActionType yang digunakan untuk meluncurkan aplikasi ini. Nilai ini null jika aplikasi tidak diluncurkan dengan intent tindakan tertentu.

  • id

    string opsional

    ID file atau pengendali URL yang digunakan untuk memanggil aplikasi. ID pengendali adalah kunci level teratas di kamus file_handlers dan/atau url_handlers dalam manifes.

  • isKioskSession

    boolean opsional

    Apakah aplikasi diluncurkan dalam sesi kios ChromeOS.

  • isPublicSession

    boolean opsional

    Chrome 47 dan yang lebih baru

    Apakah aplikasi diluncurkan dalam sesi publik ChromeOS.

  • item

    LaunchItem[] opsional

    Entri file untuk peristiwa onLaunched yang dipicu oleh pengendali file yang cocok di kunci manifes file_handlers.

  • referrerUrl

    string opsional

    URL perujuk untuk peristiwa onLaunched yang dipicu oleh pengendali URL yang cocok di kunci manifes url_handlers.

  • source

    LaunchSource opsional

    Tempat aplikasi diluncurkan.

  • url

    string opsional

    URL untuk peristiwa onLaunched yang dipicu oleh pengendali URL yang cocok di kunci manifes url_handlers.

LaunchItem

Properti

  • entri

    Entri

    Entri untuk item.

  • jenis

    string opsional

    Jenis MIME file.

LaunchSource

Enumerasi sumber peluncuran aplikasi. Ini harus tetap disinkronkan dengan AppLaunchSource di components/services/app_service/public/mojom/types.mojom, dan GetLaunchSourceEnum() di extensions/browser/api/app_runtime/app_runtime_api.cc. Perhatikan bahwa enumerasi digunakan dalam histogram UMA sehingga entri tidak boleh diurutkan ulang atau dihapus.

Enum

"untracked"

"new_tab_page"

"reload"

"restart"

"file_handler"

"url_handler"

"about_page"

"keyboard"

"ephemeral_app"

"background"

"kiosk"

"installed_notification"

"context_menu"

"intent_url"

Acara

onEmbedRequested

chrome.app.runtime.onEmbedRequested.addListener(
  callback: function,
)

Diaktifkan saat aplikasi penyematan meminta untuk menyematkan aplikasi ini. Peristiwa ini hanya tersedia di saluran developer dengan tanda --enable-app-view.

Parameter

onLaunched

chrome.app.runtime.onLaunched.addListener(
  callback: function,
)

Diaktifkan saat aplikasi diluncurkan dari peluncur.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    (launchData?: LaunchData) => void

onRestarted

chrome.app.runtime.onRestarted.addListener(
  callback: function,
)

Diaktifkan saat Chrome dimulai ke aplikasi yang sedang berjalan saat Chrome terakhir kali dimatikan, atau saat aplikasi diminta untuk dimulai ulang dari status sebelumnya karena alasan lain (misalnya, saat pengguna mencabut akses ke file yang dipertahankan aplikasi, runtime akan memulai ulang aplikasi). Dalam situasi ini, jika aplikasi tidak memiliki pengendali onRestarted, aplikasi akan menerima peristiwa onLaunched.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    () => void