LaunchParams

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

LaunchParams は起動ハンドラー API のインターフェイスで、 PWA でカスタムの起動ナビゲーション処理を実装する際に使用します。 window.launchQueue.setConsumer() を呼び出して起動ナビゲーション処理機能を設定すると、 setConsumer() の中のコールバック関数で LaunchParams オブジェクトのインスタンスが渡されます。

このようなカスタムナビゲーションは、 PWA が launch_handler の client_mode の値が focus-existing, navigate-new, navigate-existing のいずれかの設定で起動した場合に、 Window.launchQueue を通じて実行されます。

インスタンスプロパティ

LaunchParams.files 読取専用 Experimental: 起動ナビゲーションとともに POST メソッドで渡されたすべてのファイルを表す、読み取り専用の FileSystemHandle オブジェクト配列を返します。
LaunchParams.targetURL 読取専用 Experimental: 起動するターゲット URL を返します。

例

if ("launchQueue" in window) {
  window.launchQueue.setConsumer((launchParams) => {
    if (launchParams.targetURL) {
      const params = new URL(launchParams.targetURL).searchParams;

      // 再生するトラックを受け取る音楽プレーヤーアプリを想定
      const track = params.get("track");
      if (track) {
        audio.src = track;
        title.textContent = new URL(track).pathname.substr(1);
        audio.play();
      }
    }
  });
}