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 を返します。
例
js
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();
}
}
});
}
仕様書
| Specification |
|---|
| Web App Launch Handler API # launchparams-interface |