chrome.app.runtime

說明

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

類型

ActionData

Chrome 54 以上版本

屬性

  • actionType

    "new_note"

ActionType

Chrome 54 以上版本

啟動某個應用程式後，你可以指定特定動作，例如建立新記事。在應用程式啟動時使用的動作類型，可在 LaunchData 執行個體的 actionData 欄位中提供。

值

"new_note"

EmbedRequest

屬性

  • 資料

    任何選用

    選擇性開發人員指定要嵌入應用程式的資料，可用於決定嵌入項目。

  • embedderId

    字串

  • allow

    void

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

    allow 函式如下所示： 

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

    • 網址

      字串

  • deny

    void

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

    deny 函式如下所示： 

    () => {...}

LaunchData

屬性

  • actionData

    ActionData 選用

    Chrome 54 以上版本

    包含用於指定啟動這個應用程式時所用 ActionType 的資料。如果應用程式並非以特定動作意圖啟動，則為空值。

  • id

    string optional

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

  • isKioskSession

    布林值 選填

    指出應用程式是否在 Chrome 作業系統資訊站工作階段中啟動。

  • isPublicSession

    布林值 選填

    Chrome 47 以上版本

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

  • items

    LaunchItem[] 選用

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

  • referrerUrl

    string optional

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

  • 來源

    LaunchSource 選用

    應用程式的啟動位置。

  • 網址

    string optional

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

LaunchItem

屬性

  • 項目

    項目

    項目項目。

  • 類型

    string optional

    檔案的 MIME 類型。

LaunchSource

應用程式啟動來源列舉。這個 ID 必須與元件/services/app_service/public/mojom/types.mojom 中的 AppLaunchSource 與擴充功能/browser/api/app_runtime/app_runtime_api.cc 中的 GetLaunchSourceEnum() 保持同步。請注意，列舉在 UMA 直方圖中使用，因此不應重新排序或移除項目。

列舉

"已取消追蹤"

&quot;app_launcher&quot;

"new_tab_page"

"重新載入"

"restart"

&quot;load_and_launch&quot;

"command_line"

&quot;file_handler&quot;

"url_handler"

"system_tray"

"about_page"

"鍵盤"

&quot;extensions_page&quot;

"management_api"

&quot;ephemeral_app&quot;

「背景」

「資訊站」

"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;

「閃亮」

活動

onEmbedRequested

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

當嵌入的應用程式要求嵌入此應用程式時觸發。這個事件僅適用於加上 --enable-app-view 標記的開發頻道。

參數

onLaunched

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

透過啟動器啟動應用程式時觸發。

參數

  • 回呼

    函式

    callback 參數如下所示： 

    (launchData?: LaunchData) => void

onRestarted

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

在 Chrome 啟動時啟動，且應用程式是在 Chrome 上次關閉時執行，或基於其他原因要求重新啟動應用程式 (例如使用者撤銷應用程式保留檔案的存取權時，執行階段會重新啟動應用程式)。在這類情況下，如果應用程式沒有 onRestarted 處理常式，就會改為傳送 onLaunched 事件。

參數

  • 回呼

    函式

    callback 參數如下所示： 

    () => void