LaunchParams

实验性： 这是一个 实验性技术
在生产环境中使用之前，请仔细查看 浏览器兼容性表。

LaunchParams 接口属于 启动处理程序 API，用于在 PWA 中实现自定义启动导航处理。当调用 window.launchQueue.setConsumer() 设置启动导航处理功能时，setConsumer() 内部的回调函数会传递一个 LaunchParams 对象实例。

当 PWA 使用 focus-existing、navigate-new 或 navigate-existing 的 launch_handler client_mode 值启动时，通过 Window.launchQueue 启动此类自定义导航处理。

实例属性

LaunchParams.files 只读

返回一个只读数组，其中包含表示通过 POST 方法与启动导航一起传递的任何文件的 FileSystemHandle 对象。

LaunchParams.targetURL 只读

返回启动的目标 URL。

示例

js
if ("launchQueue" in window) {
  window.launchQueue.setConsumer((launchParams) => {
    if (launchParams.targetURL) {
      const params = new URL(launchParams.targetURL).searchParams;

      // Assuming a music player app that gets a track passed to it to be played
      const track = params.get("track");
      if (track) {
        audio.src = track;
        title.textContent = new URL(track).pathname.substr(1);
        audio.play();
      }
    }
  });
}

规范

规范
Web 应用启动处理程序 API
# launchparams-interface

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅