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 dan yang lebih baru

Properti

  • actionType

    "new_note"

ActionType

Chrome 54 dan yang lebih baru

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

"new_note"

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 dalam 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 sinkron dengan AppLaunchSource di component/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 disusun ulang atau dihapus.

Enum

"tidak terlacak"

&quot;app_launcher&quot;

"halaman_tab_baru"

"muat ulang"

"mulai ulang"

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

"url_handler"

"system_tray"

"halaman_tentang"

"keyboard"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

"latar belakang"

"kios"

"chrome_internal"

"test"

&quot;installed_notification&quot;

&quot;context_menu&quot;

"arc"

&quot;intent_url&quot;

&quot;app_home_page&quot;

&quot;focus_mode&quot;

"kilau"

Acara

onEmbedRequested

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

Diaktifkan saat aplikasi penyematan meminta untuk menyematkan aplikasi ini. Peristiwa ini hanya tersedia pada saluran pengembang 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 memulai Chrome untuk aplikasi yang sedang berjalan saat Chrome terakhir dinonaktifkan, atau saat aplikasi diminta untuk memulai ulang dari status sebelumnya karena alasan lain (misalnya, jika pengguna mencabut akses ke file aplikasi yang dipertahankan, runtime akan memulai ulang aplikasi). Dalam situasi ini, jika aplikasi tidak memiliki pengendali onRestarted, aplikasi akan dikirim peristiwa onLaunched.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti ini: 

    () => void