launch_handler

實驗性: 這是一個 實驗性技術
在生產環境中使用之前,請仔細檢視 瀏覽器相容性表

型別 物件

launch_handler 成員定義了控制網頁應用程式啟動的值。目前它只能包含一個值,client_mode,它指定應用程式啟動時應載入的上下文。例如,在包含應用程式例項的現有網頁應用程式客戶端中,或者在新的網頁應用程式客戶端中。這為將來定義更多 launch_handler 值留下了空間。

launch_handler 專案值

launch_handler 物件可能包含以下值

成員 描述
client_mode

字串或逗號分隔的字串陣列,它指定應用程式啟動時應載入的上下文。如果提供字串陣列,則使用第一個有效值。可能的取值是

auto
使用者代理決定平臺應在何種上下文中載入應用程式。例如,navigate-existing 在移動裝置上可能更有意義,因為移動裝置通常只有一個應用程式例項,而 navigate-new 在桌面環境中可能更有意義。如果所有提供的值都無效,則使用此預設值。
focus-existing
如果應用程式已載入到網頁應用程式客戶端中,則會將其置於焦點,但不會導航到啟動目標 URL。目標 URL 透過 Window.launchQueue 提供,允許實現自定義啟動導航處理。如果應用程式尚未載入到網頁應用程式客戶端中,則改為使用 navigate-new 行為。
如果應用程式已載入到網頁應用程式客戶端中,則會將其置於焦點並導航到指定的啟動目標 URL。目標 URL 透過 Window.launchQueue 提供,允許實現額外的自定義啟動導航處理。如果應用程式尚未載入到網頁應用程式客戶端中,則改為使用 navigate-new 行為。
應用程式載入到新的網頁應用程式客戶端中。目標 URL 透過 Window.launchQueue 提供,允許實現額外的自定義啟動導航處理。

示例

json
"launch_handler": {
    "client_mode": "focus-existing"
}

"launch_handler": {
    "client_mode": ["focus-existing", "auto"]
}

規範

規範
網頁應用程式啟動處理程式 API
# launch_handler-member

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱