DOM

Window:appinstalled イベント

 編集:2022.10.18 by T.A.

[Edge]。→

Web Manifest API のイベントで、ブラウザーがあるページをアプリケーションとして成功裏にインストールしたとき発行されます。

バブリング なし
キャンセル可能 いいえ
インターフェイス Event
イベント ハンドラー プロパティ onappinstalled
インストール プロセス

インストール プロセスは、ユーザー エージェントが Web アプリケーションをしようとする試みです。このようなプロセスの詳細(つまり、インストール UI の表示、および結果として生じるホスト OS の IO 操作)は、実装者に任されています。実装者は、に直接関連するがあることに注意する必要があります。

この仕様の目的のために、インストール プロセスが Web アプリケーションのインストールに成功すると(たとえば、アイコンがデバイスのホーム画面に正常に配置された場合)、インストールは成功したことになります。エンド ユーザーがインストール プロセスをキャンセルした場合(たとえ手動でトリガーした後に気が変わったとしても)、その後、インストールはキャンセルされました。さもないと、インストールに失敗しました。インストールが失敗する理由には、次のようなものがあります。例えば、デバイスのホーム画面にアイコンを追加するユーザー エージェントへの許可を OS が拒否し、エンド ユーザーがインストールを拒否します。

インストールの手順→

Web アプリケーションをインストールする手順は、次のアルゴリズムによって示されます:

  1. window を、ユーザー エージェントがインストールを試みる最上位のブラウジング コンテキストの Window オブジェクトにします。
  2. 次に、並行して:
    1. インストール プロセスをインスタンス化します。
    2. マニフェストとマニフェスト URL は、マニフェストを取得した結果とします。
    3. マニフェストの取得でエラーが発生した場合、ユーザー エージェントは次のことができ、この時点で、トップレベルのブラウジング コンテキスト Document のメタデータを使用して、インストール プロセスの UI を設定する方法にフォールバックします。
    4. マニフェストの取得に成功すると、マニフェストを使用して Serviceworker メンバーの処理を実行した結果、有効な登録が返され、ユーザー エージェントはこの時点で、
      1. クライアントを最上位のブラウジング コンテキスト ドキュメントの関連設定オブジェクトにします。利用できない場合は null。
      2. 登録のスコープおよび src メンバーを使用して Start Register を呼び出します。新たな約束、クライアント、マニフェスト URL、さらに、登録の type および update_via_cache メンバー、

      この場合、解決済みの Promise の状態によって、インストールが成功したかどうかが決まります。

    5. インストールが成功した場合、アプリケーション ライフサイクル タスク ソースでタスクをキューに入れ、window オブジェクトで appinstalled という名前のイベントを発生させます。

HTML:

<SPAN id=IdLog></SPAN><BR>
<SPAN id=IdInd></SPAN>

JavaScript:


 


テスト