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。

示例

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
# launchparams-interface

瀏覽器相容性

另見