chrome.app.runtime

Deskripsi

Menggunakan 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

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

    opsional

    Developer opsional menentukan data yang dapat digunakan aplikasi yang akan disematkan saat membuat keputusan penyematan.

  • embedderId

    string

  • izinkan

    void

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

    Fungsi allow terlihat seperti: 

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

    • url

      string

  • tolak

    void

    Mencegah embedderId menyematkan aplikasi ini di elemen <appview>.

    Fungsi deny terlihat seperti: 

    ()=> {...}

LaunchData

Properti

  • actionData

    ActionData opsional

    Chrome 54+

    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+

    Apakah aplikasi diluncurkan dalam sesi publik ChromeOS.

  • items

    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.

  • tipe

    string opsional

    Jenis MIME file.

LaunchSource

Enumerasi sumber peluncuran aplikasi. Ini harus tetap sinkron 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 diatur ulang atau dihapus.

Enum

"app_launcher"

"load_and_launch"

"command_line"

"url_handler"

"system_tray"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"kiosk"

"chrome_internal"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

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: 

    (launchData?: LaunchData)=>void

onRestarted

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

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

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    ()=>void