LaunchParams

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。

LaunchParams 接口是 Launch Handler API 的一部分，在实现 PWA 的自定义启动导航处理时使用。当调用 window.launchQueue.setConsumer() 来设置启动导航处理功能时，`setConsumer()` 中的回调函数会接收一个 `LaunchParams` 对象实例。

这种自定义导航处理是通过 Window.launchQueue 启动的，前提是 PWA 在启动时具有 `launch_handler` 的 `client_mode` 值，且该值为 `focus-existing`、`navigate-new` 或 `navigate-existing`。

实例属性

LaunchParams.files 只读实验性: 返回一个只读的 FileSystemHandle 对象数组，这些对象代表通过 POST 方法随启动导航一起传递的任何文件。
LaunchParams.targetURL 只读实验性: 返回启动的目标 URL。

示例

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.slice(1);
        audio.play();
      }
    }
  });
}

规范

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

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025 年 9 月 8 日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题