LaunchQueue: setConsumer() 方法

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

setConsumer() 方法是 LaunchQueue 接口的一部分，用于声明一个回调函数，该函数将处理 渐进式 Web 应用 (PWA) 中的自定义启动导航处理。这种自定义导航是通过 Window.launchQueue 启动的，前提是 PWA 的 launch_handler client_mode 值为 focus-existing、navigate-new 或 navigate-existing。

语法

js
setConsumer(callback)

参数

callback

一个回调函数，用于处理 PWA 的自定义导航。回调函数会将一个 LaunchParams 对象实例作为参数传递。

返回值

undefined.

示例

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
# dom-launchqueue-setconsumer

浏览器兼容性

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

另请参阅