chrome.app.runtime

說明

使用 chrome.app.runtime API 管理應用程式生命週期。應用程式執行階段會管理應用程式安裝作業、控管事件頁面，並可隨時關閉應用程式。

類型

EmbedRequest

屬性

  • 資料

    任意 選填

    開發人員指定的選用資料，可供要嵌入的應用程式在決定是否嵌入時使用。

  • embedderId

    字串

  • allow

    void

    允許 embedderId 將這個應用程式嵌入 <appview> 元素。url 會指定要嵌入的內容。

    allow 函式如下所示： 

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

    • 網址

      字串

  • deny

    void

    禁止 embedderId 將這個應用程式嵌入 <appview> 元素。

    deny 函式如下所示： 

    () => {...}

LaunchData

屬性

  • id

    字串 選填

    叫用應用程式時使用的檔案或網址處理常式 ID。處理常式 ID 是資訊清單中 file_handlers 和/或 url_handlers 字典中的頂層鍵。

  • isKioskSession

    布林值 選填

    應用程式是否在 ChromeOS 資訊站工作階段中啟動。

  • isPublicSession

    布林值 選填

    Chrome 47 以上版本

    應用程式是否在 ChromeOS 公開工作階段中啟動。

  • 項目

    LaunchItem[] 選用

    file_handlers 資訊清單索引鍵中相符檔案處理常式觸發的 onLaunched 事件檔案項目。

  • referrerUrl

    字串 選填

    onLaunched 事件的參照網址，由 url_handlers 資訊清單鍵中相符的網址處理常式觸發。

  • 來源

    LaunchSource 選填

    應用程式的啟動位置。

  • 網址

    字串 選填

    onLaunched 事件的網址，由 url_handlers 資訊清單金鑰中相符的網址處理常式觸發。

LaunchItem

屬性

  • entry

    項目

    項目的項目。

  • 類型

    字串 選填

    檔案的 MIME 類型。

LaunchSource

應用程式啟動來源的列舉。這項設定應與 components/services/app_service/public/mojom/types.mojom 中的 AppLaunchSource，以及 extensions/browser/api/app_runtime/app_runtime_api.cc 中的 GetLaunchSourceEnum() 保持同步。請注意，列舉用於 UMA 直方圖，因此不應重新排序或移除項目。

列舉

"untracked"

"app_launcher"

"new_tab_page"

"reload"

"restart"

"load_and_launch"

"command_line"

"file_handler"

"url_handler"

"system_tray"

"about_page"

"keyboard"

"extensions_page"

"management_api"

"ephemeral_app"

"background"

"kiosk"

"chrome_internal"

"test"

"installed_notification"

"context_menu"

"arc"

"intent_url"

"app_home_page"

"focus_mode"

"sparky"

事件

onEmbedRequested

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

當嵌入應用程式要求嵌入這個應用程式時，系統會觸發這個事件。這個事件僅適用於開發人員版，且須啟用 --enable-app-view 旗標。

參數

onLaunched

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

從啟動器啟動應用程式時觸發。

參數

  • callback

    函式

    callback 參數如下： 

    (launchData?: LaunchData) => void

onRestarted

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

在 Chrome 啟動時，向 Chrome 上次關閉時正在執行的應用程式觸發，或因其他原因 (例如使用者撤銷應用程式保留檔案的存取權時，執行階段會重新啟動應用程式) 要求應用程式從先前狀態重新啟動時觸發。在這種情況下，如果應用程式沒有 onRestarted 處理常式，系統會改為傳送 onLaunched 事件。

參數

  • callback

    函式

    callback 參數如下： 

    () => void