概念

• ウィンドウコントロール： オペレーティングシステムがアプリケーション間で一貫して使用する インターフェイス要素であり、ユーザーがアプリケーションを制御する 特定の操作を実行できるようにする。[=window controls=] における 一般的な操作には、最小化、最大化／復元、閉じるボタンが含まれる。

表示モード拡張

通常の 表示モードに加えて、 [=manifest/display_override=] はそれに対する特定の拡張もサポートする。

unframed

isolated web application には、ホストネイティブのタイトルバーや [=window controls=] が表示されず、Web コンテンツがタイトルバー領域 全体へ拡張される。アプリは Web コンテンツ内に [=draggable region=] を 指定して、カスタマイズされたタイトルバーを作成できる。

[=display mode/window-controls-overlay=]

tabbed

Web アプリケーションは、複数の [=application contexts=] を単一の オペレーティングシステムレベルのウィンドウに結合できる。たとえば、 これはユーザーエージェントが、ユーザーが application contexts 間を 切り替えられるようにタブストリップ UI を表示することを意味し得る。

            {
              "name": "Recipe Zone",
              "description": "All of the recipes!",
              "icons": [{
                "src": "icon/hd_hi",
                "sizes": "128x128"
              }],
              "start_url": "/index.html",
              "display_override": ["minimal-ui"],
              "display": "standalone",
              "theme_color": "yellow",
              "background_color": "red"
            }
          

ドラッグ可能な 領域の定義

[=app-region=] CSS プロパティはどのユーザーエージェントにも実装されて いないため、at risk である。なお、一部のユーザーエージェントは 同じ目的のために非標準 CSS プロパティ `-webkit-app-region` を使用する。

`app-region` プロパティは、たとえばタイトルバー内のどの領域または要素が ドラッグ可能であるかを CSS で定義するために使用できる。

• 要素のドラッグを有効にするには、`drag` に設定しなければならない。
• 要素のドラッグを無効にするには、`no-drag` に設定しなければならない。

home_tab メンバー

[=tab_strip=] オブジェクトの `home_tab` メンバーは、アプリケーションの トップレベルメニューとして機能することを意図した特別な「ホームタブ」に 関する情報を含む ordered map である。これは次のメンバーを含む：

• [=home_tab/scope_patterns=]

scope_patterns メンバーは、 [=manifest URL=] に相対的な [=within home tab scope|ホームタブのスコープ=] を定義する {{URLPatternInput}} のリストである。

アプリケーションの適用済み [=display mode=] が [=display mode/tabbed=] であり、 [=Document/processed manifest=] が [=tab_strip=] メンバーの非 null な [=home_tab=] メンバーを含む場合、そのアプリケーションは ホームタブを持つ。

ホームタブコンテキストは、他の application contexts と比べて 特別なプロパティを持つ任意の [=application context=] である。 アプリケーションが [=has a home tab=] 場合、すべてのアプリケーション ウィンドウは [=home tab context=] を備えるべきである。そうでない場合、 アプリケーションウィンドウは [=home tab context=] を持つべきではない。

[=home tab context=] がどのように提示されるかはユーザーエージェントの 裁量に委ねられるが、通常の application contexts とは異なる外観を 持つべきである。

[=URL=] |url:URL| は、次の場合に限り ホームタブスコープ内であると言われる：

• アプリケーションが [=has a home tab=]、かつ
• |url| が manifest の [=manifest/within scope=] であり、かつ
• 次の少なくとも 1 つ：
  • |url| が [=start URL=] と [=URL/equals=] であり、 [=URL/equals/exclude fragments=] が true に設定されている、または
  • [=Document/processed manifest=] の [=tab_strip=] メンバーの [=home_tab=] メンバーの [=scope_patterns=] メンバーの任意の要素と |url| を与えて [=URL pattern/match=] を適用した結果が {{URLPatternResult}} を返す。

URL は [=within home tab scope=] でない場合、ホームタブスコープ外である。

new_tab_button メンバー

[=tab_strip/new_tab_button=] メンバーは、クリック／有効化されたときに アプリケーションウィンドウ内で新しい [=application context=] を開く UI アフォーダンス（ボタンなど）の挙動を記述する ordered map である。 これは次のメンバーを持つ：

• [=new_tab_button/url=]

url メンバーは、 [=manifest URL=] に相対的な URL を表す文字列であり、 [=Document/processed manifest=] の [=manifest/within scope=] である。

[=Document/processed manifest=] の [=new_tab_button=] の [=new_tab_button/url=] メンバーが [=outside of home tab scope=] である場合、 アプリケーションは 新しいタブボタンを持つ。アプリケーションが [=has a new tab button|新しいタブボタンを持たない=] 場合、 ユーザーエージェントは「新しいタブ」アフォーダンスをエンドユーザーに 利用可能にするべきではない。

エンドユーザーによって新しいタブボタンが有効化されたとき、次の手順が 実行される：

1. 現在のウィンドウ内に [=Create a new application context=] し、 それをフォーカスする。
2. [=new_tab_button=] の [=new_tab_button/url=] メンバーの値へ ナビゲートする。

`tab_strip` メンバーの処理

[=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map|、 および [=URL=] |manifest URL:URL| が与えられたとき、 process the `tab_strip` member するには、 [=processing a manifest=] における 拡張ポイントで次を実行する：

1. |manifest|["tab_strip"] を新しい [=ordered map=] に設定する。
2. |json|["tab_strip"] が存在しない、または |json|["tab_strip"] が [=ordered map=] でない場合：
   1. |manifest|["tab_strip"]["new_tab_button"]["url"] を |manifest|["start_url"] に設定する。
   2. 戻る。
3. |json|["tab_strip"]、 |manifest|["tab_strip"]、および |manifest URL| を渡して [=Process the `home_tab` member=]。
4. |json|["tab_strip"]、|manifest|["tab_strip"]、|manifest URL|、および |manifest|["start_url"] を渡して [=Process the `new_tab_button` member=]。

new_note_url メンバー

[=note_taking=] `new_note_url` メンバーは、ユーザーが Web アプリケーションを 使用して新しいノートを取りたいとき（例：オペレーティングシステムの ショートカットアイコンやキーボードショートカットから）に、 ユーザーエージェントに読み込ませることを開発者が望む URL を表す [=string=] である。

`new_note_url` メンバーは純粋に助言的であり、ユーザーエージェントは それを無視してもよく、 それを使用するかどうかをエンドユーザーが選択できるようにしてもよい。 ユーザーエージェントは、エンドユーザーがそれを変更できるようにしてもよい。

`note_taking` メンバーの処理

[=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map|、 [=URL=] |manifest_URL:URL| が与えられたとき、 process the `note_taking` member するには、 [=processing a manifest=] における 拡張 ポイントで次を実行する：

1. |json|["note_taking"] が [=map/exist=] しない場合、戻る。
2. |json|["note_taking"] の型が [=ordered map=] でない場合、 戻る。
3. |manifest|["note_taking"] を新しい [=ordered map=] に設定する。
4. |json|["note_taking"], |manifest|["note_taking"], および |manifest URL| を 渡して [=process the `new_note_url` member=]。

`new_note_url` メンバーの処理

[=ordered map=] |json_note_taking:ordered map|、[=ordered map=] |manifest_note_taking:ordered map|、[=URL=] |manifest_URL:URL| が 与えられたとき、process the `new_note_url` member するには、 次を実行する：

1. |json_note_taking|["new_note_url"] が [=map/exist=] しない場合、 戻る。
2. |json_note_taking|["new_note_url"] の型が [=string=] でない場合、戻る。
3. |new_note_url:URL| を、|manifest URL| を基底 URL として |json_note_taking|["new_note_url"] を [=URL Parser|解析=] した結果とする。
4. |new_note_url| が failure の場合、戻る。
5. |new_note_url| が |manifest URL| の [=manifest/within scope=] でない場合、戻る。
6. manifest_note_taking["new_note_url"] を |new_note_url| に設定する。

`new_note_url` の起動

処理済み manifest |manifest:processed manifest| が与えられたとき、 launch the `new_note_url` するには、次の手順を実行する：

1. |manifest|["note_taking"] が [=map/exist=] しない場合、戻る。
2. |manifest|["note_taking"]["new_note_url"] が [=map/exist=] しない場合、戻る。
3. |manifest|["note_taking"]["new_note_url"] の型が [=URL=] でない場合、戻る。
4. |manifest| を |manifest| に、 |target URL| を |manifest|["note_taking"]["new_note_url"] に設定して、 [=launch a web application=] する手順を実行する。

ユーザーエージェントは、通常はユーザーアフォーダンスへの応答として、 任意の時点で、与えられた [=installed web application=] について [=launch the `new_note_url`=] してもよい。

`protocol_handlers` メンバーの処理

[=object=] |json:JSON|、|manifest:ordered map| が与えられたとき、 process the `protocol_handlers` member するには：

1. |json:JSON|["|protocol_handlers|"] の新しい [=list=] を |processedProtocolHandlers| とする。
2. manifest["|protocol_handlers|"] を |processedProtocolHandlers| に設定する。
3. |protocol_handler|（protocol handler description）それぞれについて [=list/For each=]：
   1. |protocol_handler|["protocol"] または |protocol_handler|["url"] が undefined の場合、[=iteration/continue=]。
   2. |protocol_handler|["protocol"]、| protocol_handler|["url"] を、 |manifest URL| を基底 URL として、かつ [=this=] の関連する [=environment settings object=] を使用して、 [=normalize protocol handler parameters=] を実行した結果を (|normalizedProtocol:string|, |normalizedUrl:URL|) とする。 結果が failure の場合、[=iteration/continue=]。
   3. |normalizedUrl| が |manifest| の [=manifest/within scope=] でない場合、 [=iteration/continue=]。
   4. |processedProtocolHandlers| が |normalizedUrl| を [=list/contains=] する場合、[=iteration/continue=]。
   5. |protocol_handler| を |processedProtocolHandlers| に [=List/Append=] する。
4. |processedProtocolHandlers| それぞれについて [=list/For each=]、 ユーザーエージェントは [=register a protocol handler=] するべきである。

ユーザーエージェントは、ホストオペレーティングシステムでプロトコルの 既定 handler として [=protocol handler description=] protocol_handlers を登録する前に、ユーザーに許可を求めるべきである。 ユーザーエージェントは、ホストオペレーティングシステムの慣例または制限との 一貫性を保つため、提示される [=protocol handler description=] protocol_handlers のリストを切り詰めてもよい。

Protocol handler 項目

各 protocol handler description は、Web アプリケーションが 処理したいプロトコルを表す [=object=] であり、 [=manifest/protocol_handlers=] メンバーに対応する。 これは次のメンバーを持つ：

• [=protocol handler description/protocol=]
• [=protocol handler description/url=]

ユーザーエージェントは、これらの値を使用して、Web アプリケーションを operating system の handler として登録するべきである。 ユーザーが protocol handler URL を有効化したとき、ユーザーエージェントは handling a protocol launch を実行するべきである。

[[HTML]] の {{NavigatorContentUtils/registerProtocolHandler()}} は、 Web サイトが特定のプロトコルの可能な handler として自分自身を登録することを 可能にする。protocol handler description に対する 有効な [=protocol handler description/protocol=] および [=protocol handler description/url=] の値を構成するものは、その API で定義される。 なお、[[HTML]] API は、ここで [=protocol handler description/protocol=] を 使用する場所で scheme を使用するが、同じ制限が適用される。

プライバシー上の考慮事項：既定の protocol handler

オペレーティングシステムの機能によっては、protocol handler は、ユーザーが 明示的に知ることなく、与えられたプロトコルの「既定」handler （例：与えられたプロトコルの起動を自動的に処理する）になる可能性がある。 起こり得る悪用を防ぐため、ユーザーエージェントは次のような保護を 採用してもよい：

• [=invoke a protocol handler=] の処理を実行する前に 明示的なユーザー同意を要求する。
• 上記のダイアログへの応答、またはユーザー操作によって、 Web アプリケーションの OS 登録を protocol handling entity として削除する。
• [=installation=] 時に protocol handler 登録を確認する。

ユーザーエージェントが protocol handler entity の登録を削除する場合、 ユーザーが Web アプリおよびプロトコルをオペレーティングシステムに 再登録できる UX を提供するべきである。

File Handler 項目

各 file handler は、 アプリケーションのスコープ内の URL であって、それが受け入れる [=file types=] を伴う起動を処理できるものを表す。 これは次のメンバーを持つ：

• [=file handler/action=]
• [=file handler/name=]
• [=file handler/accept=]
• [=file handler/icons=]

ユーザーエージェントは、これらのメンバーを使用して Web アプリケーションを オペレーティングシステム上の [=file type=] と関連付けることができる。

file type は [=MIME type=] および／または [=file extension=] によって定義できる。OS がそのファイルに [=MIME type=] があると判断する場合、またはその名前が特定の [=file extension=] で終わる場合、そのファイルは file type に属する。 file extension は "." で始まり、 有効な suffix code pointsのみを含む文字列である。さらに、[=file extensions=] は 16 コードポイントの長さに制限される。

file handler 項目の処理

[=ordered map=] |item:ordered map|、[=URL=] |start_url:URL|、 [=URL=] |scope:URL|、および [=URL=] |manifest URL:URL| が与えられたとき、 process a file handler item するには：

1. 次のいずれかが true の場合、failure を返す：
   • |item|["action"] が [=map/exist=] しない、または [=string=] でない。
   • |item|["accept"] が [=map/exist=] しない。
   • |item|["accept"] が [=dictionary=] でない。
   • |item|["accept"] が [=map/is empty=] である。
2. |url:URL| を、|manifest_url URL| を基底 URL として |item|["action"] を [=URL Parser|解析=] した結果とする。
3. |url| が failure の場合、failure を返す。
4. |url| が |scope| の [=manifest/within scope=] でない場合、 failure を返す。
5. |launch_type:string| を、"single-client" で初期化された 新しい [=string=] とする。
6. |item|["launch_type"] が [=map/exists=] し、 "multiple-clients" である場合、|launch_type| を |item|["launch_type"] に設定する。
7. |accept:ordered map| を新しい [=ordered map=] とする。
8. |item|["accept"] の |mime_type_string:string| → |extensions| について [=map/for each=]
   1. |extensions| が [=list=] でない場合、[=iteration/continue=]。
   2. |extensions| が [=list/empty=] の場合、[=iteration/continue=]。
   3. |extensions| が [=string=] でない項目を [=list/contains=] する場合、 [=iteration/continue=]。
   4. |extensions| が文字 `.` で始まらない文字列を [=list/contains=] する場合、 [=iteration/continue=]。
   5. |extensions| が 16 文字より長い文字列を [=list/contains=] する場合、 [=iteration/continue=]。
   6. |mime_type_string| に対して [=parse a mime type=] の手順を実行した結果を |mime_type_parsed:mime type| とする。
   7. |mime_type_parsed:mime type| が failure の場合、 [=iteration/continue=]。
   8. |mime_type_parsed/type| が [[IANA-MEDIA-TYPES]] における top-level type として列挙されていない場合、[=iteration/continue=]。
   9. |accept|[|mime_type_string|] を |extensions| に設定する。
9. |accept:ordered map| が空の場合、failure を返す。
10. |file_handler:ordered map| を |ordered map| «[ "action" → |url|, "name" → |item|["name"], "launch_type" → |launch_type|, "accept" → |accept| ]» とする。
11. |item|["icons"]、|file_handler|、 |manifest URL|、および "icons" を渡して、 画像リソースを 処理する。
12. |file_handler| を返す。

file handler 起動の実行

execute a file handler launch する手順は、 次のアルゴリズムで与えられる。このアルゴリズムは [=list=] |files:list| と、 [=processing a manifest=] からの結果を保持する [=ordered map=] |manifest:ordered_map| を取る。

1. |file_handlers:list| を |manifest|["file_handlers"] とする。
2. |file_handlers:list| が null の場合、戻る。
3. |launches:ordered map| を [=ordered map=] とする。
4. |files| の |filename:string| それぞれについて [=list/for each=]
   1. |file_handlers:list| の |file_handler:ordered_map| それぞれについて [=list/for each=]：
      1. |file_handler|["accept"] の |mime_type_string:string| → |extensions:list| について [=map/for each=]
         1. |extensions| の |extension:string| それぞれについて [=list/for each=]：
            1. |filename| が |extension| で終わらない場合、 [=iteration/continue=]。
            2. |launches|[|file_handler|] が [=map/exists=] する場合、 |filename| を |launches|[|file_handler|] に [=list/append=] する。
            3. そうでない場合、|launches|[|file_handler|] を 単一要素 |filename| を持つ [=list=] に設定する。
            4. |files| の次の要素へ [=iteration/Continue=] する。
5. |launches| の |file_handler| → |files:list| について [=map/for each=]
   1. |file_handler|["launch_type"] が "multiple-clients" に等しい場合
      1. |files| の |file| それぞれについて [=list/for each=]
         1. {{LaunchParams/targetURL}} を |file_handler|["action"] に設定し、{{LaunchParams/files}} を |file| に対応する単一の {{FileSystemHandle}} 要素を持つ {{FrozenArray}} に設定した、新しい {{LaunchParams}} |params:LaunchParams| とする。
         2. |manifest| と |params| を渡して [=Launch a web application with handling=]。
   2. そうでない場合、
      1. {{LaunchParams/targetURL}} を |file_handler|["action"] に設定し、 {{LaunchParams/files}} を |files| によって名付けられたファイルパスに 対応する {{FileSystemHandle}} の {{FrozenArray}} に設定した、 新しい {{LaunchParams}} |params:LaunchParams| とする。
      2. |manifest| と |params| を渡して [=Launch a web application with handling=]。

file handler の登録

ユーザーエージェントは、次と整合するように、ホスト オペレーティングシステムに register file handlers するべきである：

• アプリは、ネイティブファイルブラウザーや、与えられたファイルまたは file type を処理できるアプリのリストを表示するその他のサーフェスなど、 適切な OS サーフェスに公開される。
• アプリは、関連付けられた file types についてシステムの既定 handler になる 候補である。

ユーザーエージェントは、機能を維持し乱用を防ぐため、 [=file extensions=] の総集合を切り詰めてもよい。 ユーザーエージェントは、特定の filetypes との関連付けを防いでもよい。

プライバシー上の考慮事項：既定の file handler。

オペレーティングシステムの機能によっては、[=file handler=] はユーザーが 明示的に知ることなく、与えられた [=file type=] の既定 handler となり、 与えられた file type の起動を自動的に処理する可能性がある。 起こり得る悪用を防ぐため、[=user agents=] は [=execute a file handler launch=] する処理を開始するために、 明示的なユーザー同意を要求してもよい。同意が求められる場合、 ユーザーエージェントは、その決定が永続的であることをユーザーが指定できるように するべきであり、そのように指定された場合は、Web アプリケーションの OS 登録を file handling entity として削除するべきである。

プライバシー上の考慮事項：名前とアイコン。

各 file handler の名前とアイコンは、ユーザーがそれらを確認するための 指定された方法がないため、プライバシーおよびセキュリティ上センシティブで あり得る。このため、[=user agents=] は、代替の文字列やアイコンを優先して これらを無視する、または OS の既定値へフォールバックすることを選択してもよい。

`scope_extensions` メンバーの処理

[=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map|、 および [=URL=] |manifest_id:URL| が与えられたとき、 process the `scope_extensions` member するには：

1. |processedScopeExtensions:list| を新しい [=list=] とする。
2. |manifest|["scope_extensions"] を |processedScopeExtensions| に設定する。
3. |json|["scope_extensions"] が [=map/exist=] しない、または [=list=] でない場合、戻る。
4. |json|["scope_extensions"] の |entry:ordered map| それぞれについて [=list/For each=]：
   1. |entry|["type"] または |entry|["origin"] が [=map/exist=] しない場合、 [=iteration/continue=]。
   2. |entry|["type"] が "origin" でない場合、[=iteration/continue=]。
   3. |entry|["origin"] が [=string=] でない場合、 [=iteration/continue=]。
   4. |entry|["origin"] を [=URL Parser|解析=] した結果を [=URL=] |origin_url:URL| とする。
   5. |origin_url| が [=URL/scheme=] "https" を持つ有効な |URL| である場合、 |entry|["origin"] を |origin_url| の [=URL/origin=] に設定する。
   6. そうでなければ [=iteration/continue=]。
   7. [=ordered map=] |entry:ordered map| および [=URL=] |manifest_id:URL| が与えられたとして、 [=validate scope extensions=] のアルゴリズムを用いて |entry| を検証する。
   8. 直前の手順が error を返した場合、 [=iteration/continue=]。
   9. そうでない場合、|entry|["scope"] を返された [=URL=] に設定する。
   10. |entry| を |processedScopeExtensions| に [=list/Append=] する。

scope extensions の検証

[=ordered map=] |extension:ordered map| および [=URL=] |manifest_id:URL| が 与えられたとき、validate scope extensions するには：

1. |extension|["origin"] の [=URL/origin=] の [=URL=] を [=URL=] |origin_url:URL| とする。
2. |origin_url| を基底 [=URL=] として "/.well-known/web-app-origin-association" を [=URL Parser|解析=] した結果を [=URL=] |download_url:URL| とする。
3. |download_url| を与えて [=fetch=] した結果を [=ordered map=] |json:ordered map| とする。
4. [=fetch=] が失敗した場合、error を返す。
5. |json|[|manifest_id|] が [=map/exist=] しない、または [=ordered map=] でない場合、error を返す。
6. |scope:string| を [=string=] "/" とする。
7. |json|[|manifest_id|]["scope"] が [=map/exists=] し、 [=string=] である場合、|scope| を |json|[|manifest_id|]["scope"] に設定する。
8. |extension|["origin"] を基底 [=URL=] として |scope| を [=URL Parser|解析=] した結果を [=URL=] |resolved_scope:URL| とする。
9. |resolved_scope| を返す。

scope extensions の適用

ユーザーエージェントは、シナリオによって apply extended scope を 適用し、別のシナリオでは [=manifest/scope=] を適用することを選択してもよい。

[=application context=] の [=navigable/active document=] の [=URL=] が [=manifest/within scope=] ではないが [=within extended scope=] である場合、ユーザーエージェントは、ユーザーがその [=URL=] または 少なくともその [=origin=] を判断できる UI を提供するべきであり、 それが安全な接続で提供されているかどうかも含めるべきである。 この UI は、[=URL=] が [=application context=] の [=Document/processed manifest=] の [=manifest/within scope=] でない場合に 使用される UI とは異なるべきである。これは、ユーザーがアプリケーションの 意図された内容をナビゲートしていることを明確にしつつ、異なる [=origin=] へナビゲートすることのプライバシーおよびセキュリティ上の 影響についてユーザーに情報を与え続けるためである。

migrate_from メンバー

[=manifest/migrate_from=] メンバーは、移行元である古い Web アプリケーションを識別する [=strings=] または [=ordered maps=] の [=list=] である。

エントリが [=string=] である場合、それは古いアプリケーションの [=manifest/id=] として扱われる。

エントリが [=ordered map=] である場合、次のメンバーを持つことができる：

• id： 古いアプリケーションの [=manifest/id=] を表す [=string=]。
• install_url：古いアプリケーションの manifest へリンクするページの URL を表す [=string=]。 ユーザーエージェントは、古いアプリケーションの一部である他のすべての URL が新しいアプリケーションへリダイレクトする場合でも、更新を適用するために 古いアプリケーションの manifest を取得する目的でこのフィールドを使用できる。
• behavior： `"suggest"` または `"force"` のいずれかである [=string=]。 これは、移行についてユーザーに通知するためにユーザーエージェントが提示する UI がどの程度強制的であるかに影響し得るヒントである。

migrate_to メンバー

[=manifest/migrate_to=] メンバーは、新しいアプリケーションへの移行を 先回りして通知する任意の [=ordered map=] である。これは次のメンバーを持つ：

• id： 新しいアプリケーションの [=manifest/id=] を表す [=string=]。
• install_url：新しいアプリケーションの manifest へリンクするページの URL を表す [=string=]。 このページ上の manifest は、移行が処理されるために、このアプリケーションへ 戻る [=manifest/migrate_from=] フィールドを含む必要がある。

origin migration の検証

[=URL=] |old_manifest_id:URL| および [=URL=] |new_manifest_id:URL| が 与えられたとき、validate origin migration するには：

1. |old_manifest_id| の [=URL/origin=] と |new_manifest_id| の [=URL/origin=] が [=same site=] でない場合、error を返す。
2. |old_manifest_id| の [=URL/origin=] が |new_manifest_id| の [=URL/origin=] と [=same origin=] である場合、success を返す。
3. |old_manifest_id| の [=URL/origin=] の [=URL=] を [=URL=] |origin_url:URL| とする。
4. |origin_url| を基底 [=URL=] として "/.well-known/web-app-origin-association" を [=URL Parser|解析=] した結果を [=URL=] |download_url:URL| とする。
5. |download_url| を与えて [=fetch=] した結果を [=ordered map=] |json:ordered map| とする。
6. [=fetch=] が失敗した場合、error を返す。
7. |json|[|new_manifest_id|] が [=map/exist=] しない、または [=ordered map=] でない場合、error を返す。
8. |json|[|new_manifest_id|]["allow_migration"] が `true` でない場合、 error を返す。
9. success を返す。

`migrate_from` メンバーの処理

[=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map|、 および [=URL=] |manifest URL:URL| が与えられたとき、 process the `migrate_from` member するには：

1. |json|["id"] が [=map/exist=] しない、または [=string=] でない場合、 戻る。
2. |json|["id"] が空文字列の場合、戻る。
3. |base_origin:origin| を |manifest|["start_url"] の [=URL/origin=] とする。
4. |id_url:URL| を、|base_origin| を基底 URL として |json|["id"] を [=URL Parser|解析=] した結果とする。
5. |id_url| が failure の場合、戻る。
6. |id_url| が |manifest|["start_url"] と [=same origin=] でない場合、 戻る。
7. |processed_migrate_from:list| を新しい [=list=] とする。
8. |manifest|["migrate_from"] を |processed_migrate_from| に設定する。
9. |json|["migrate_from"] が [=map/exist=] しない、または [=list=] でない場合、戻る。
10. |json|["migrate_from"] の |entry| それぞれについて [=list/For each=]：
    1. |processed_entry:ordered map| を新しい [=ordered map=] とする。
    2. |entry| が [=string=] の場合：
       1. |manifest URL| を基底 URL として |entry| を [=URL Parser|解析=] した結果を |id:URL| とする。
       2. |id| が failure の場合、[=iteration/continue=]。
       3. |processed_entry|["id"] を |id| に設定する。
    3. そうでなく、|entry| が [=ordered map=] の場合：
       1. |entry|["id"] が [=map/exist=] しない、または [=string=] でない場合、[=iteration/continue=]。
       2. |manifest URL| を基底 URL として |entry|["id"] を [=URL Parser|解析=] した結果を |id:URL| とする。
       3. |id| が failure の場合、[=iteration/continue=]。
       4. |processed_entry|["id"] を |id| に設定する。
       5. |entry|["install_url"] が [=map/exists=] し、 [=string=] である場合：
          1. |manifest URL| を基底 URL として |entry|["install_url"] を [=URL Parser|解析=] した結果を |install_url:URL| とする。
          2. |install_url| が failure でない場合、 |processed_entry|["install_url"] を |install_url| に設定する。
       6. |entry|["behavior"] が [=map/exists=] し、 [=string=] である場合：
          1. |entry|["behavior"] が "suggest" または "force" である場合、 |processed_entry|["behavior"] を |entry|["behavior"] に設定する。
    4. そうでなければ、[=iteration/continue=]。
    5. [=URL=] |processed_entry|["id"] および [=URL=] |id_url| が 与えられたとして、[=validate origin migration=] のアルゴリズムを 用いて |processed_entry|["id"] を検証する。
    6. 直前の手順が error を返した場合、 [=iteration/continue=]。
    7. |processed_entry| を |processed_migrate_from| に [=list/Append=] する。

`migrate_to` メンバーの処理

[=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map|、 および [=URL=] |manifest URL:URL| が与えられたとき、 process the `migrate_to` member するには：

1. |json|["migrate_to"] が [=map/exist=] しない、または [=ordered map=] でない場合、戻る。
2. |entry:ordered map| を |json|["migrate_to"] とする。
3. |entry|["id"] が [=map/exist=] しない、または [=string=] でない場合、 戻る。
4. |manifest URL| を基底 URL として |entry|["id"] を [=URL Parser|解析=] した結果を |id:URL| とする。
5. |id| が failure の場合、戻る。
6. |processed_migrate_to:ordered map| を新しい [=ordered map=] とする。
7. |processed_migrate_to|["id"] を |id| に設定する。
8. |entry|["install_url"] が [=map/exists=] し、[=string=] である場合：
   1. |manifest URL| を 基底 URL として |entry|["install_url"] を [=URL Parser|解析=] した結果を |install_url:URL| とする。
   2. |install_url| が failure でない場合、 |processed_migrate_to|["install_url"] を |install_url| に設定する。
9. |manifest|["migrate_to"] を |processed_migrate_to| に設定する。

プライバシーおよびセキュリティの考慮事項

悪意ある主体がアプリケーションを密かに乗っ取ること（例：単純な電卓が自身を更新して 銀行アプリを模倣すること）を防ぐため、[=validate origin migration=] アルゴリズムは 双方向のハンドシェイクを強制する。新旧両方のアプリケーション origin は、 [=web-app-origin-association=] ファイルを介して移行に明示的に同意しなければならない。

さらに、移行は [=same site=] であることに制限され、未検証の第三者へ所有権を移すのではなく、 組織の管理下での正当なリブランディングおよびアーキテクチャ変更に使用されることを保証する。

ユーザーエージェントは、特にセキュリティ上センシティブなフィールド （アプリ名やアイコンなど）の更新が含まれる場合、移行フローの一部として 明示的なユーザー確認ダイアログを含めることを検討するべきである。

`platform` メンバー

platform メンバーは、 この [=external application resource=] が関連付けられている [=platform=] を表す。platform は、 ソフトウェア配布エコシステム、または場合によってはオペレーティングシステムを 表す。この仕様は platform メンバーの特定の値を定義しない。

`url` メンバー

[=external application resource's=] url メンバーは、 アプリケーションを見つけることができる URL である。

process the `url` member of an application するには：

1. application URL が欠落している場合、null を返す。
2. そうでなければ、application URL を [=URL Parser|解析=] し、 結果が failure でない場合、その結果を返す。そうでなければ null を返す。

`id` メンバー

[=external application resource's=] id メンバーは、 プラットフォーム上でアプリケーションを表すために使用される id を表す。

`min_version` メンバー

[=external application resource's=] min_version メンバーは、 この Web アプリに関連すると見なされるアプリケーションの最小バージョンを表す。 このバージョンは、プラットフォーム固有の構文および意味を持つ string である。

`fingerprints` メンバー

[=external application resource's=] fingerprints メンバーは、 [=fingerprints=] の [=list=] を表す。

fingerprint は、 アプリケーションの検証に使用される暗号学的 fingerprint の集合を表す。 fingerprint は次の 2 つのメンバーを持つ：type と value。これらはいずれも string であるが、その構文と意味はプラットフォーム定義である。

Installation 処理

steps to install the web application は次のアルゴリズムで与えられる：

1. manifest を、installable document の manifest とする。
2. ユーザーのオペレーティングシステムに Web アプリケーションを登録しようとするため、 未指定の一連のアクションを実行する（例：Web アプリケーションを起動する ショートカットを作成する、システムのアンインストールメニューに アプリケーションを登録する、など）。インストールが失敗した場合 （これは任意の理由で起こり得る。たとえば、OS がユーザーエージェントに デバイスのホーム画面へアイコンを追加する許可を拒否する場合など）、 これらの手順を中止する。
3. インストールが行われた [=top-level browsing context=] の [=relevant global object=] で `"appinstalled"` という名前の fire an event をするために、 application life-cycle task source 上で Queue a task する。

BeforeInstallPromptEvent インターフェイス

          [Exposed=Window]
          interface BeforeInstallPromptEvent : Event {
            constructor(DOMString type, optional EventInit eventInitDict = {});
            Promise<PromptResponseObject> prompt();
          };

          dictionary PromptResponseObject {
            AppBannerPromptOutcome userChoice;
          };

          enum AppBannerPromptOutcome {
            "accepted",
            "dismissed"
          };
        

{{BeforeInstallPromptEvent}} は、サイトが site-triggered install prompt を提示することを許可されたとき、 またはユーザーエージェントが automated install prompt を提示する前に dispatch される。これは、サイトが automated install prompt を cancel できるようにし、さらに site-triggered install prompt を 手動で提示できるようにする。

PromptResponseObject は {{BeforeInstallPromptEvent/prompt()}} を呼び出した結果を含む。 それは 1 つのメンバー、 userChoice を含み、 ユーザーが選択した結果を表す。

{{BeforeInstallPromptEvent}} のインスタンスは、次の内部スロットを持つ：

[[\didPrompt]]

初期値 `false` の boolean。このイベントがエンドユーザーに present an install prompt するために使用されたかどうかを表す。

[[\userResponsePromise]]

presenting an install prompt の結果を表す promise。

              window.addEventListener("beforeinstallprompt", event => {
                // Suppress automatic prompting.
                event.preventDefault();

                // Show the (disabled-by-default) install button. This button
                // resolves the installButtonClicked promise when clicked.
                installButton.disabled = false;

                // Wait for the user to click the button.
                installButton.addEventListener("click", async e => {
                  // The prompt() method can only be used once.
                  installButton.disabled = true;

                  // Show the prompt.
                  const userChoice = await event.prompt();
                  console.info(`user choice was: ${userChoice}`);
                });
              });
            

`Window` オブジェクトへの拡張

          partial interface Window {
            attribute EventHandler onappinstalled;
            attribute EventHandler onbeforeinstallprompt;
          };