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

瀏覽器相容性

另見