LaunchQueue: setConsumer() 方法

可用性有限

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

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

setConsumer() 方法是 LaunchQueue 接口的一部分,用于声明一个回调函数,该函数将处理渐进式 Web 应用(PWA)中的自定义启动导航。当 PWA 使用了 launch_handlerclient_mode 值为 focus-existingnavigate-newnavigate-existing 启动时,此自定义导航会通过 Window.launchQueue 启动。

语法

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

规范

规范
Web 应用启动处理程序 API
# dom-launchqueue-setconsumer

浏览器兼容性

另见