このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
LaunchParams
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more support for this feature? Tell us why.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
LaunchParams は 起動ハンドラー API のインターフェイスで、 PWA でカスタムの起動ナビゲーション処理を実装する際に使用します。 window.launchQueue.setConsumer() を呼び出して起動ナビゲーション処理機能を設定すると、 setConsumer() の中のコールバック関数で LaunchParams オブジェクトのインスタンスが渡されます。
このようなカスタムナビゲーションは、 PWA が launch_handler の client_mode の値が focus-existing, navigate-new, navigate-existing のいずれかの設定で起動した場合に、 Window.launchQueue を通じて実行されます。
インスタンスプロパティ
LaunchParams.files読取専用-
起動ナビゲーションとともに
POSTメソッドで渡されたすべてのファイルを表す、読み取り専用のFileSystemHandleオブジェクト配列を返します。 LaunchParams.targetURL読取専用-
起動するターゲット 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();
}
}
});
}
仕様書
| 仕様書 |
|---|
| Web App Launch Handler API # launchparams-interface |
ブラウザーの互換性
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。