このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
launch_handler
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental:これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
launch_handler メンバーは、ウェブアプリケーションの起動を制御する値を定義します。現時点では、このメンバーには単一の値client_mode しか設定できません。この値は、アプリケーションが起動された際に読み込むべきコンテキストを指定します。例えば、アプリケーションのインスタンスを含む既存のウェブアプリケーションクライアントであったり、または新しいウェブアプリケーションクライアントであったりです。これにより、将来的にlaunch_handler の値をさらに定義できる余地が残されています。
値
launch_handler オブジェクトは次の値を持つことができます。
client_modeExperimental文字列、またはカンマで区切られた文字列の配列で、アプリケーションが起動された際に読み込まれるコンテキストを指定します。文字列の配列が指定された場合、最初の有効な値が使用されます。利用可能な値は次の通りです。
autoプラットフォームがアプリを読み込む際に、どのコンテキストが適切であるかを判断するのはユーザーエージェントです。例えば、単一のアプリインスタンスが一般的であるモバイルでは、
navigate-existingの方が適切である可能性が高いのに対し、デスクトップではnavigate-newの方が適切である可能性が高いでしょう。これは、提供された値がすべて不正な場合に用いられる既定値です。focus-existingアプリがすでにウェブアプリクライアントに読み込まれている場合、フォーカスは当たるものの、起動対象の URL には移動しません。 対象とする URL は、
Window.launchQueueを介して利用できるため、カスタム起動のナビゲーション処理を実装することができます。 アプリがウェブアプリクライアントに読み込まれていない場合、代わりにnavigate-newの動作が使用されます。navigate-existingアプリがすでにウェブアプリクライアントに読み込まれている場合、そのアプリがフォーカスされ、指定した起動ターゲット URL に移動します。 対象とする URL は、
Window.launchQueueを介して利用できるため、追加のカスタム起動ナビゲーション処理を実装することができます。 アプリがウェブアプリクライアントに読み込まれていない場合、代わりにnavigate-newの動作が使用されます。navigate-newこのアプリは新しいウェブアプリクライアントに読み込まれました。対象とする URL は、
Window.launchQueueを介して利用でき、追加のカスタム起動ナビゲーション処理を実装できるようになっています。
例
"launch_handler": { "client_mode": "focus-existing"}"launch_handler": { "client_mode": ["focus-existing", "auto"]}仕様書
| Specification |
|---|
| Web App Launch Handler API # launch_handler-member |