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 表格仅在浏览器中加载

另请参阅