确定所选显示模式

以下步骤被添加到 确定 Web 应用程序的所选显示模式中的 [=application manifest/processing extension-point=]，该过程现在还会 接受一个可选的 [=URL=] |document URL|：

1. 对于 |manifest:ordered map| 的 [=manifest/display_override=] 成员中的 每个 |entry:display override entry| 执行 [=list/For each=]：
   1. 令 |candidate display mode| 为 null。
   2. 如果 |entry| 是一个 [=display mode=]：
      1. 将 |candidate display mode| 设置为 |entry|。
   3. 否则，如果 |entry| 是一个 [=DisplayOverrideEntryObject=]：
      1. 如果 |entry| 的 [=DisplayOverrideEntryObject/url_patterns=] [=list/is empty=]：
         1. 将 |candidate display mode| 设置为 |entry| 的 [=DisplayOverrideEntryObject/display=]。
      2. 否则，如果 |document URL| 不为 null：
         1. 对于 |entry| 的 [=DisplayOverrideEntryObject/url_patterns=] 中的 每个 |pattern| 执行 [=list/For each=]：
            1. 如果 |pattern| [=URL pattern/matches=] |document URL|，则将 |candidate display mode| 设置为 |entry| 的 [=DisplayOverrideEntryObject/display=] 并 [=iteration/break=]。
   4. 如果 |candidate display mode| 为 null，则 [=iteration/continue=]。
   5. 如果 显示模式列表包含 |candidate display mode|，则返回该 |candidate display mode|。
   6. 如果 |candidate display mode| 是 [=display mode/window-controls-overlay=]，且 [=user agent=] 支持此模式，则返回该 |candidate display mode|。
   7. 如果 |candidate display mode| 是 [=display mode/tabbed=]，且 [=user agent=] 支持此模式， 则返回该 |candidate display mode|。
   8. 如果 |candidate display mode| 是 [=display mode/unframed=]，[=user agent=] 支持此模式， 且应用程序是一个 Isolated Web Application [[isolated-web-apps]]，则返回该 |candidate display mode|。

处理 `display_override` 成员

要处理 `display_override` 成员，给定 [=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map| 和 [=URL=] |manifest URL:URL|，运行以下步骤：

1. 将 |manifest|["display_override"] 设置为一个新的 [=list=]。
2. 如果 |json|["display_override"] 不 [=map/exist=]，则返回。
3. 如果 |json|["display_override"] 不是一个 [=list=]，则返回。
4. 令 |processed display override:list| 为一个新的 [=list=]。
5. 对于 |json|["display_override"] 的每个 |entry| 执行 [=list/For each=]：
   1. 如果 |entry| 是一个 [=string=]：
      1. 如果 显示模式列表 （包括 [=display mode extensions|extensions=]）包含 |entry|，则将 |entry| [=list/append=] 到 |processed display override|。
   2. 否则，如果 |entry| 是一个 [=ordered map=]：
      1. 如果 |entry|["display"] 不 [=map/exist=] 或不是一个 [=string=]， 则 [=iteration/continue=]。
      2. 如果 显示模式列表 （包括 [=display mode extensions|extensions=]）不包含 |entry|["display"]，则 [=iteration/continue=]。
      3. 如果 [=user agent=] 不支持 |entry|["display"] 的 URL patterns， 则 [=iteration/continue=]。
      4. 令 |override object| 为一个新的 [=DisplayOverrideEntryObject=]，其 [=DisplayOverrideEntryObject/display=] 被设置为 |entry|["display"]。
      5. 如果 |entry|["url_patterns"] [=map/exists=]：
         1. 如果 |entry|["url_patterns"] 不是一个 [=list=]，则 [=iteration/continue=]。
         2. 对于 |entry|["url_patterns"] 的每个 |pattern entry| 执行 [=list/For each=]：
            1. 令 |pattern:URL pattern| 为给定 |pattern entry| 和 |manifest URL| 后 [=build a URL pattern from an infra value=] 的结果。 如果此过程抛出异常或返回 null，则 [=iteration/continue=]。
            2. 将 |pattern| [=list/append=] 到 |override object| 的 [=DisplayOverrideEntryObject/url_patterns=]。
      6. 将 |override object| [=list/append=] 到 |processed display override|。
6. 将 |manifest|["display_override"] 设置为 |processed display override|。

概念

• 窗口控件： 操作系统在各个应用程序中一致使用的界面元素，用于让用户执行某些 操作来控制应用程序。[=window controls=] 中的常见操作包括最小化、 最大化/还原和关闭按钮。
• 窗口框架： 围绕应用程序窗口中 Web 内容的宿主原生装饰，包括边框、标题栏和窗口控件。

显示模式扩展

除了普通的 显示模式之外， [=manifest/display_override=] 还支持某些 显示模式扩展。

[=display mode/unframed=]

应用窗口处于 [=display mode/unframed=]，这意味着它没有 [=Window frame=]。 它没有任何宿主原生标题栏，并且 [=window controls=] 不可见。 Web 内容会扩展到整个窗口区域。[=display mode/Unframed=] 被限制为 仅用于 [[[isolated-web-apps]]]。

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

应用窗口具有 [=display mode/window-controls-overlay=]，而不是常规的 [=window controls=]。

tabbed

Web 应用程序可以拥有多个 [=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"
            }
          

unframed 显示模式

[=display mode/unframed=] 显示模式使 [[[isolated-web-apps]]] 能够完全 控制应用窗口的外观，包括标题栏区域。

处于 [=display mode/unframed=] 的窗口没有任何宿主原生标题栏或 [=window controls=] 可见，并且 Web 内容会扩展到整个窗口区域。 应用可以在 Web 内容中指定 [=draggable regions=] 来创建自定义标题栏。

[=User agents=] MUST 将 [=display mode/unframed=] 的使用限制为 仅用于 [[[isolated-web-apps]]]。

一旦创建了 [=display mode/unframed=] 窗口，其显示模式在该窗口的 生命周期内就是固定的。[=user agent=] MUST NOT 允许在无框架窗口内 导航到范围外 URL。

视觉示例

以下图示说明了标准 Web 应用程序窗口与使用 [=display mode/unframed=] 显示模式的窗口之间的视觉差异。 普通应用窗口（左）包含宿主原生标题栏和标准窗口控件。 相比之下，无框架应用窗口（右）移除了这些宿主提供的框架装饰， 允许 Web 内容占据整个窗口区域。

            @media (display-mode: unframed) {
              /* styles for unframed mode */
            }
          

定义可拖拽 区域

`app-region` 属性可用于通过 CSS 定义哪些区域或元素（例如标题栏中的区域或元素） 是可拖拽的。

• 要启用某个元素的拖拽，应设置为 `drag`。
• 要禁用某个元素的拖拽，应设置为 `no-drag`。

`app-region` 属性 MUST 仅在窗口的已应用 [=display mode=] 为 [=display mode/unframed=] 或 [=display mode/window-controls-overlay=] 时生效。

home_tab 成员

[=tab_strip=] 对象的 `home_tab` 成员是一个 ordered map， 其中包含关于一个特殊“home tab”的信息，该标签预期用作应用程序的 顶级菜单。它包含以下成员：

• [=home_tab/scope_patterns=]

scope_patterns 成员是一个 {{URLPatternInput}} 的列表，它定义相对于 [=manifest URL=] 的 [=within home tab scope|home tab 的作用域=]。

如果应用程序的已应用 [=display mode=] 是 [=display mode/tabbed=]， 且 [=Document/processed manifest=] 在 [=tab_strip=] 成员中包含一个非 null 的 [=home_tab=] 成员，则称该应用程序具有 home tab。

home tab context 是一个可选的 [=application context=]，与其他 application contexts 相比具有特殊属性。 如果应用程序 [=has a home tab=]，则每个应用程序窗口 SHOULD 具有一个 [=home tab context=]。如果不是，则应用程序窗口 SHOULD NOT 具有 [=home tab context=]。

[=home tab context=] 的呈现方式由用户代理自行决定，但它 SHOULD 具有不同于普通 application contexts 的外观。

当且仅当满足以下条件时，称一个 [=URL=] |url:URL| 位于 home tab 作用域内：

• 应用程序 [=has a home tab=]，并且
• |url| 是清单的 [=manifest/within scope=]，并且
• 至少满足以下之一：
  • |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=]，则称它位于 home tab 作用域外。

new_tab_button 成员

[=tab_strip/new_tab_button=] 成员是一个 ordered map， 它描述一个 UI affordance（例如按钮）的行为；当该 UI affordance 被点击/激活时，会在应用程序窗口内打开一个新的 [=application context=]。 它具有以下成员：

• [=new_tab_button/url=]

url 成员 是一个表示相对于 [=manifest URL=] 的 URL 的字符串， 该 URL 是 [=Document/processed manifest=] 的 [=manifest/within scope=]。

如果 [=Document/processed manifest=] 的 [=new_tab_button=] 的 [=new_tab_button/url=] 成员 [=outside of home tab scope=]， 则称应用程序具有 new tab button。如果应用程序不 [=has a new tab button|have a new tab button=]，则用户代理 SHOULD NOT 向最终用户提供“new tab” affordance。

当最终用户激活 new tab button 时，运行以下步骤：

1. 在当前窗口中 [=Create a new application context=] 并聚焦它。
2. 将其导航到 [=new_tab_button=] 的 [=new_tab_button/url=] 成员值。

处理 `tab_strip` 成员

要处理 `tab_strip` 成员，给定 [=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map| 和 [=URL=] |manifest URL:URL|，在 [=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. [=Process the `home_tab` member=]，传入 |json|["tab_strip"]、 |manifest|["tab_strip"] 和 |manifest URL|。
4. [=Process the `new_tab_button` member=]，传入 |json|["tab_strip"]、|manifest|["tab_strip"]、|manifest URL| 和 |manifest|["start_url"]。

new_note_url 成员

[=note_taking=] `new_note_url` 成员是一个 [=string=]， 表示开发者希望用户代理在用户想使用 Web 应用程序创建新笔记时 加载的 URL （例如，从操作系统快捷方式图标或键盘快捷键启动时）。

`new_note_url` 成员纯粹是建议性的，用户代理可以 忽略它，或向 最终用户提供是否使用它的选择。用户代理可以向最终用户提供 修改它的选择。

处理 `note_taking` 成员

要处理 `note_taking` 成员，给定 [=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map|、[=URL=] |manifest_URL:URL|，在 [=processing a manifest=] 的 扩展 点期间运行以下步骤：

1. 如果 |json|["note_taking"] 不 [=map/exist=]，返回。
2. 如果 |json|["note_taking"] 的类型不是 [=ordered map=]， 返回。
3. 将 |manifest|["note_taking"] 设置为一个新的 [=ordered map=]。
4. [=process the `new_note_url` member=]，传入 |json|["note_taking"]、|manifest|["note_taking"] 和 |manifest URL|。

处理 `new_note_url` 成员

要处理 `new_note_url` 成员，给定 [=ordered map=] |json_note_taking:ordered map|、[=ordered map=] |manifest_note_taking:ordered map|、[=URL=] |manifest_URL:URL|，运行 以下步骤：

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 [=URL Parser|解析=] |json_note_taking|["new_note_url"] 所得的结果。
4. 如果 |new_note_url| 是失败，返回。
5. 如果 |new_note_url| 不是 |manifest URL| 的 [=manifest/within scope=]，返回。
6. 将 manifest_note_taking["new_note_url"] 设置为 |new_note_url|。

启动 `new_note_url`

要启动 `new_note_url`，给定 已处理清单 |manifest:processed manifest|，运行以下步骤：

1. 如果 |manifest|["note_taking"] 不 [=map/exist=]，返回。
2. 如果 |manifest|["note_taking"]["new_note_url"] 不 [=map/exist=]，返回。
3. 如果 |manifest|["note_taking"]["new_note_url"] 的类型不是 [=URL=]，返回。
4. 运行 [=launch a web application=] 的步骤，将 |manifest| 设置为 |manifest|，并将 |target URL| 设置为 |manifest|["note_taking"]["new_note_url"]。

用户代理可以随时为给定的 [=installed web application=] [=launch the `new_note_url`=]，通常是响应用户便利项。

处理 `protocol_handlers` 成员

要处理 `protocol_handlers` 成员，给定 [=object=] |json:JSON|、|manifest:ordered map|：

1. 令 |processedProtocolHandlers| 为一个新的 [=list=]， 由 |json:JSON|["|protocol_handlers|"] 组成。
2. 将 manifest["|protocol_handlers|"] 设置为 |processedProtocolHandlers|。
3. [=list/For each=] |protocol_handler|（协议处理器 描述）：
   1. 如果 |protocol_handler|["protocol"] 或 |protocol_handler|["url"] 为 undefined，则 [=iteration/continue=]。
   2. 令 (|normalizedProtocol:string|, |normalizedUrl:URL|) 为使用 |manifest URL| 作为基准 URL，并使用 [=this=] 的相关 [=environment settings object=]，以 |protocol_handler|["protocol"]、| protocol_handler|["url"] 运行 [=normalize protocol handler parameters=] 所得的结果。 如果结果为失败，则 [=iteration/continue=]。
   3. 如果 |normalizedUrl| 不是 |manifest| 的 [=manifest/within scope=]，则 [=iteration/continue=]。
   4. 如果 |processedProtocolHandlers| [=list/contains=] |normalizedUrl|，则 [=iteration/continue=]。
   5. [=List/Append=] |protocol_handler| 到 |processedProtocolHandlers|。
4. [=list/For each=] |processedProtocolHandlers|，用户代理 应 [=register a protocol handler=]。

用户代理应在将 [=protocol handler description=] protocol_handlers 注册为宿主操作系统中某协议的 默认处理器之前请求用户许可。用户代理可以截断所呈现的 [=protocol handler description=] protocol_handlers 列表，以保持与宿主操作系统的惯例或限制一致。

协议处理器项

每个 协议处理器描述 是一个 [=object=]， 表示 Web 应用程序想要处理的协议，对应于 [=manifest/protocol_handlers=] 成员。它具有以下成员：

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

用户代理应使用这些值将 Web 应用程序注册为操作系统中的处理器。 当用户激活协议处理器 URL 时，用户代理应运行 处理协议启动。

隐私考虑：默认协议处理器

根据操作系统能力，协议处理器可能会在用户没有明确知情的情况下 成为给定协议的“默认”处理器（例如自动处理给定协议的启动）。 为防止可能的滥用，用户代理可以采用如下保护措施：

• 在执行 [=invoke a protocol handler=] 的过程之前， 要求用户明确同意。
• 移除 Web 应用程序作为协议处理实体的 OS 注册， 可以是响应上述对话框，也可以由用户操作触发。
• 在 [=installation=] 时确认协议处理器注册。

如果用户代理移除协议处理器实体的注册，则应为用户提供 UX， 以便用户可重新向操作系统注册 Web 应用和协议。

文件处理器项

每个 文件处理器 表示 应用程序作用域内的一个 URL，该 URL 可处理带有其所接受 [=file types=] 的启动。它具有以下成员：

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

用户代理可以使用这些成员，在操作系统上将 Web 应用程序与 [=file type=] 关联。

文件类型可由 [=MIME type=] 和/或 [=file extension=] 定义。如果 OS 判定文件具有某个 [=MIME type=]，和/或其名称以某个 [=file extension=] 结尾， 则该文件属于某个文件类型。文件扩展名是一个 以 "." 开头且只包含 有效 后缀代码 点的字符串。此外，[=file extensions=] 被限制为 16 个代码点的长度。

处理文件处理器项

要处理文件处理器项，给定 [=ordered map=] |item:ordered map|、[=URL=] |start_url:URL|、[=URL=] |scope:URL| 和 [=URL=] |manifest URL:URL|：

1. 如果以下任一条件为真，则返回 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 [=URL Parser|解析=] |item|["action"] 所得的结果。
3. 如果 |url| 是 failure，返回 failure。
4. 如果 |url| 不是 |scope| 的 [=manifest/within scope=]， 返回 failure。
5. 令 |launch_type:string| 为一个新的 [=string=]，并初始化为 "single-client"。
6. 如果 |item|["launch_type"] [=map/exists=] 且为 "multiple-clients"，则将 |launch_type| 设置为 |item|["launch_type"]。
7. 令 |accept:ordered map| 为一个新的 [=ordered map=]。
8. [=map/for each=] |mime_type_string:string| → |extensions|，其属于 |item|["accept"]
   1. 如果 |extensions| 不是 [=list=]，则 [=iteration/continue=]。
   2. 如果 |extensions| 是 [=list/empty=]，则 [=iteration/continue=]。
   3. 如果 |extensions| [=list/contains=] 非 [=string=] 项，则 [=iteration/continue=]。
   4. 如果 |extensions| [=list/contains=] 不以字符 `.` 开头的字符串，则 [=iteration/continue=]。
   5. 如果 |extensions| [=list/contains=] 长度大于 16 个字符的字符串，则 [=iteration/continue=]。
   6. 令 |mime_type_parsed:mime type| 为在 |mime_type_string| 上运行 [=parse a mime type=] 的步骤所得的结果。
   7. 如果 |mime_type_parsed:mime type| 是 failure， 则 [=iteration/continue=]。
   8. 如果 |mime_type_parsed/type| 未被列为 [[IANA-MEDIA-TYPES]] 中的顶级类型，则 [=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|。

执行文件处理器启动

执行文件处理器启动的步骤由以下算法给出。 该算法接受 [=list=] |files:list| 和一个 [=ordered map=] |manifest:ordered_map|，该有序映射保存 [=processing a manifest=] 的结果。

1. 令 |file_handlers:list| 为 |manifest|["file_handlers"]。
2. 如果 |file_handlers:list| 为 null，返回。
3. 令 |launches:ordered map| 为一个 [=ordered map=]。
4. [=list/for each=] |filename:string|，其属于 |files|
   1. [=list/for each=] |file_handler:ordered_map|，其属于 |file_handlers:list|：
      1. [=map/for each=] |mime_type_string:string| → |extensions:list|，其属于 |file_handler|["accept"]
         1. [=list/for each=] |extension:string|，其属于 |extensions|：
            1. 如果 |filename| 不以 |extension| 结尾， 则 [=iteration/continue=]。
            2. 如果 |launches|[|file_handler|] [=map/exists=]， 则 [=list/append=] |filename| 到 |launches|[|file_handler|]。
            3. 否则，将 |launches|[|file_handler|] 设置为 一个 [=list=]，其中唯一元素为 |filename|。
            4. [=iteration/Continue=] 到 |files| 的下一个元素。
5. [=map/for each=] |file_handler| → |files:list|，其属于 |launches|
   1. 如果 |file_handler|["launch_type"] 等于 "multiple-clients"
      1. [=list/for each=] |file|，其属于 |files|
         1. 令 |params:LaunchParams| 为一个新的 {{LaunchParams}}， 其中 {{LaunchParams/targetURL}} 设置为 |file_handler|["action"]，且 {{LaunchParams/files}} 设置为 一个 {{FrozenArray}}，其中唯一元素是与 |file| 对应的 {{FileSystemHandle}}。
         2. [=Launch a web application with handling=]，传入 |manifest| 和 |params|。
   2. 否则，
      1. 令 |params:LaunchParams| 为一个新的 {{LaunchParams}}， 其中 {{LaunchParams/targetURL}} 设置为 |file_handler|["action"]， 且 {{LaunchParams/files}} 设置为由与 |files| 指定的文件路径 对应的 {{FileSystemHandle}} 组成的 {{FrozenArray}}。
      2. [=Launch a web application with handling=]，传入 |manifest| 和 |params|。

注册文件处理器

用户代理应以与以下内容一致的方式，在宿主操作系统中 注册文件处理器：

• 应用会暴露在适当的 OS 界面中，例如原生文件浏览器 和显示可处理给定文件或文件类型的应用列表的其他界面。
• 应用是成为相关文件类型系统默认处理器的候选者。

用户代理可以截断 [=file extensions=] 的总集合，以保留功能并防止滥用。 用户代理可以阻止与某些文件类型建立关联。

隐私考虑：默认文件处理器。

根据操作系统能力，[=file handler=] 可能会在用户没有明确知情的情况下 成为给定 [=file type=] 的默认处理器，自动处理给定文件类型的启动。 为防止可能的误用，[=user agents=] 可以要求用户明确同意才开始 [=execute a file handler launch=] 的过程。如果请求同意，用户代理应允许用户指定该决定是永久的； 如果如此指定，则应移除 Web 应用程序作为文件处理实体的 OS 注册。

隐私考虑：名称和图标。

每个文件处理器的名称和图标可能涉及隐私和安全，因为没有指定 用户查看并确认这些内容的方式。因此，[=user agents=] 可以选择忽略 这些内容，转而使用替代字符串和图标，或回退到 OS 默认值。

处理 `scope_extensions` 成员

要处理 `scope_extensions` 成员，给定 [=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map| 和 [=URL=] |manifest_id:URL|：

1. 令 |processedScopeExtensions:list| 为一个新的 [=list=]。
2. 将 |manifest|["scope_extensions"] 设置为 |processedScopeExtensions|。
3. 如果 |json|["scope_extensions"] 不 [=map/exist=] 或不是 [=list=]，返回。
4. [=list/For each=] |entry:ordered map|，其属于 |json|["scope_extensions"]：
   1. 如果 |entry|["type"] 或 |entry|["origin"] 不 [=map/exist=]， 则 [=iteration/continue=]。
   2. 如果 |entry|["type"] 不是 "origin"，则 [=iteration/continue=]。
   3. 如果 |entry|["origin"] 不是 [=string=]， 则 [=iteration/continue=]。
   4. 令 [=URL=] |origin_url:URL| 为 [=URL Parser|解析=] |entry|["origin"] 所得的结果。
   5. 如果 |origin_url| 是具有 [=URL/scheme=] "https" 的有效 |URL|，则将 |entry|["origin"] 设置为 |origin_url| 的 [=URL/origin=]。
   6. 否则 [=iteration/continue=]。
   7. 使用 [=validate scope extensions=] 中的算法验证 |entry|，给定 [=ordered map=] |entry:ordered map| 和 [=URL=] |manifest_id:URL|。
   8. 如果上一步返回错误， 则 [=iteration/continue=]。
   9. 否则，将 |entry|["scope"] 设置为返回的 [=URL=]。
   10. [=list/Append=] |entry| 到 |processedScopeExtensions|。

验证作用域扩展

要验证作用域扩展，给定 [=ordered map=] |extension:ordered map| 和 [=URL=] |manifest_id:URL|：

1. 令 [=URL=] |origin_url:URL| 为 |extension|["origin"] 的 [=URL/origin=] 的 [=URL=]。
2. 令 [=URL=] |download_url:URL| 为使用 |origin_url| 作为基准 [=URL=] [=URL Parser|解析=] "/.well-known/web-app-origin-association" 所得的结果。
3. 令 [=ordered map=] |json:ordered map| 为给定 |download_url| 进行 [=fetch=] 所得的结果。
4. 如果 [=fetch=] 失败，返回错误。
5. 如果 |json|[|manifest_id|] 不 [=map/exist=] 或不是 [=ordered map=]，返回错误。
6. 令 [=string=] |scope:string| 为 "/"。
7. 如果 |json|[|manifest_id|]["scope"] [=map/exists=] 且是 [=string=]，则将 |scope| 设置为 |json|[|manifest_id|]["scope"]。
8. 令 [=URL=] |resolved_scope:URL| 为以 |extension|["origin"] 作为基准 [=URL=] [=URL Parser|解析=] |scope| 所得的结果。
9. 返回 |resolved_scope|。

应用作用域扩展

用户代理可以选择在某些场景中应用 应用扩展作用域，而在其他场景中应用 [=manifest/scope=]。

如果 [=application context=] 的 [=navigable/active document=] 的 [=URL=] 不是 [=manifest/within scope=]，但 [=within extended scope=]，则用户代理应提供 UI，允许用户确定该 [=URL=] 或至少其 [=origin=]，包括它是否通过安全连接提供。该 UI 应区别于 当 [=URL=] 不是 [=application context=] 的 [=Document/processed manifest=] 的 [=manifest/within scope=] 时 使用的任何 UI，以便明显表明用户仍在导航该应用程序的预期内容， 但也让用户了解导航到不同 [=origin=] 的隐私和安全影响。

migrate_from 成员

[=manifest/migrate_from=] 成员是一个由 [=strings=] 或 [=ordered maps=] 组成的 [=list=]，用于标识正在从中迁移的 旧 Web 应用程序。

如果条目是 [=string=]，则将其视为旧应用程序的 [=manifest/id=]。

如果条目是 [=ordered map=]，它可以具有以下成员：

• id： 表示旧应用程序 [=manifest/id=] 的 [=string=]。
• install_url：一个 [=string=]， 表示链接到旧应用程序清单的页面的 URL。用户代理可以使用此字段 获取旧应用程序的清单，以便即使旧应用程序的其他每个 URL 都重定向到新应用程序，也能应用更新。
• behavior： 一个 [=string=]，可以是 `"suggest"` 或 `"force"`。这是给用户代理的 提示，可能影响用户代理向用户呈现迁移相关 UI 的强制程度。

migrate_to 成员

[=manifest/migrate_to=] 成员是一个可选的 [=ordered map=]， 用于主动发出向新应用程序迁移的信号。它具有以下成员：

• id： 表示新应用程序 [=manifest/id=] 的 [=string=]。
• install_url：一个 [=string=]， 表示链接到新应用程序清单的页面的 URL。此页面上的清单需要包含 指向此应用程序的 [=manifest/migrate_from=] 字段， 才能处理迁移。

验证源迁移

要验证源迁移，给定 [=URL=] |old_manifest_id:URL| 和 [=URL=] |new_manifest_id:URL|：

1. 如果 |old_manifest_id| 的 [=URL/origin=] 和 |new_manifest_id| 的 [=URL/origin=] 不是 [=same site=]，返回错误。
2. 如果 |old_manifest_id| 的 [=URL/origin=] 与 |new_manifest_id| 的 [=URL/origin=] 是 [=same origin=]， 返回 success。
3. 令 [=URL=] |origin_url:URL| 为 |old_manifest_id| 的 [=URL/origin=]。
4. 令 [=URL=] |download_url:URL| 为使用 |origin_url| 作为基准 [=URL=] [=URL Parser|解析=] "/.well-known/web-app-origin-association" 所得的结果。
5. 令 [=ordered map=] |json:ordered map| 为给定 |download_url| 进行 [=fetch=] 所得的结果。
6. 如果 [=fetch=] 失败，返回错误。
7. 如果 |json|[|new_manifest_id|] 不 [=map/exist=] 或不是 [=ordered map=]，返回错误。
8. 如果 |json|[|new_manifest_id|]["allow_migration"] 不是 `true`， 返回错误。
9. 返回 success。

处理 `migrate_from` 成员

要处理 `migrate_from` 成员，给定 [=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map| 和 [=URL=] |manifest URL:URL|：

1. 如果 |json|["id"] 不 [=map/exist=]，或者不是一个 [=string=]， 则返回。
2. 如果 |json|["id"] 是空字符串，则返回。
3. 令 |base_origin:origin| 为 |manifest|["start_url"] 的 [=URL/origin=]。
4. 令 |id_url:URL| 为使用 |base_origin| 作为 base URL 对 |json|["id"] 进行 [=URL Parser|parsing=] 的结果。
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. 令 |id:URL| 为使用 |manifest URL| 作为 base URL 对 |entry| 进行 [=URL Parser|parsing=] 的结果。
       2. 如果 |id| 是 failure，则 [=iteration/continue=]。
       3. 将 |processed_entry| 的 [=migrate_from_item/id=] 设置为 |id|。
    3. 否则，如果 |entry| 是一个 [=ordered map=]：
       1. 如果 |entry| 的 [=migrate_from_item/id=] 不 [=map/exist=]，或者不是一个 [=string=]，则 [=iteration/continue=]。
       2. 令 |id:URL| 为使用 |manifest URL| 作为 base URL 对 |entry| 的 [=migrate_from_item/id=] 进行 [=URL Parser|parsing=] 的结果。
       3. 如果 |id| 是 failure，则 [=iteration/continue=]。
       4. 将 |processed_entry| 的 [=migrate_from_item/id=] 设置为 |id|。
       5. 如果 |entry| 的 [=migrate_from_item/install_url=] [=map/exists=]，并且是一个 [=string=]：
          1. 令 |install_url:URL| 为使用 |manifest URL| 作为 base URL 对 |entry| 的 [=migrate_from_item/install_url=] 进行 [=URL Parser|parsing=] 的结果。
          2. 如果 |install_url| 不是 failure，则将 |processed_entry| 的 [=migrate_from_item/install_url=] 设置为 |install_url|。
       6. 如果 |entry| 的 [=migrate_from_item/behavior=] [=map/exists=]，并且是一个 [=string=]：
          1. 如果 |entry| 的 [=migrate_from_item/behavior=] 是 "suggest" 或 "force"，则将 |processed_entry| 的 [=migrate_from_item/behavior=] 设置为 |entry| 的 [=migrate_from_item/behavior=]。
    4. 否则，[=iteration/continue=]。
    5. 使用 [=validate origin migration=] 的算法，给定 [=URL=] |processed_entry| 的 [=migrate_from_item/id=] 和 [=URL=] |id_url|， 验证 |processed_entry| 的 [=migrate_from_item/id=]。
    6. 如果上一步返回了 error， 则 [=iteration/continue=]。
    7. 将 |processed_entry| [=list/Append=] 到 |processed_migrate_from|。

处理 `migrate_to` 成员

要处理 `migrate_to` 成员，给定 [=ordered map=] |json:ordered map|、[=ordered map=] |manifest:ordered map| 和 [=URL=] |manifest URL:URL|：

1. 如果 |json|["migrate_to"] 不 [=map/exist=]，或者不是一个 [=ordered map=]，则返回。
2. 令 |entry:ordered map| 为 |json|["migrate_to"]。
3. 如果 |entry| 的 [=migrate_to_item/id=] 不 [=map/exist=]，或者不是一个 [=string=]， 则返回。
4. 令 |id:URL| 为使用 |manifest URL| 作为 base URL 对 |entry| 的 [=migrate_to_item/id=] 进行 [=URL Parser|parsing=] 的结果。
5. 如果 |id| 是 failure，则返回。
6. 令 |processed_migrate_to:ordered map| 为一个新的 [=ordered map=]。
7. 将 |processed_migrate_to| 的 [=migrate_to_item/id=] 设置为 |id|。
8. 如果 |entry| 的 [=migrate_to_item/install_url=] [=map/exists=]，并且是一个 [=string=]：
   1. 令 |install_url:URL| 为使用 |manifest URL| 作为 base URL 对 |entry| 的 [=migrate_to_item/install_url=] 进行 [=URL Parser|parsing=] 的结果。
   2. 如果 |install_url| 不是 failure，则将 |processed_migrate_to| 的 [=migrate_to_item/install_url=] 设置为 |install_url|。
9. 将 |manifest|["migrate_to"] 设置为 |processed_migrate_to|。

隐私与安全考虑

为防止恶意行为者静默接管应用程序（例如，一个简单计算器将自身更新为模仿银行应用）， [=validate origin migration=] 算法强制执行双向握手。 新旧应用程序源都必须通过 [=web-app-origin-association=] 文件 明确同意迁移。

此外，迁移被限制为 [=same site=]，以确保它们用于组织控制范围内 的合法品牌重塑和架构变更，而不是将所有权转移给未经验证的第三方。

用户代理应考虑将显式用户确认对话框作为迁移流程的一部分， 尤其是在包含对安全敏感字段（例如应用名称和图标）的更新时。

`platform` 成员

platform 成员表示 此 [=external application resource=] 所关联的 [=platform=]。 平台 表示软件分发生态系统， 或可能表示操作系统。本规范不定义 platform 成员的具体值。

`url` 成员

[=external application resource's=] url 成员是可以找到该应用程序的 URL。

要处理应用程序的 `url` 成员：

1. 如果 application URL 缺失，返回 null。
2. 否则，[=URL Parser|解析=] application URL；如果 结果不是 failure，返回该结果。否则返回 null。

`id` 成员

[=external application resource's=] id 成员表示 在平台上用于表示该应用程序的 id。

`min_version` 成员

[=external application resource's=] min_version 成员 表示被认为与此 Web 应用相关的应用程序最低版本。此版本是一个 字符串，具有平台特定的语法和语义。

`fingerprints` 成员

[=external application resource's=] 的 fingerprints 成员 表示一个 [=fingerprints=] 的 [=list=]。

fingerprint 表示一组用于 验证应用程序的密码学指纹。fingerprint 具有以下两个成员：type 和 value。它们各自都是 string， 但其语法和语义由平台定义。

安装过程

安装 Web 应用程序的步骤由以下算法给出：

1. 令 manifest 为可安装文档的清单。
2. 执行一系列未指定的操作，以尝试在用户的操作系统中注册 Web 应用程序（例如，创建启动 Web 应用程序的快捷方式、 在系统卸载菜单中注册应用程序等）。如果安装失败 （可能出于任何原因，例如 OS 拒绝授予用户代理将图标添加到 设备主屏幕的权限），则中止这些步骤。
3. 在 application life-cycle task source 上 排入一个任务，以在发生安装的 [=top-level browsing context=] 的 [=relevant global object=] 上 触发事件，事件名为 `"appinstalled"`。

BeforeInstallPromptEvent 接口

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

          dictionary PromptResponseObject {
            AppBannerPromptOutcome userChoice;
          };

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

当允许站点呈现站点触发的安装提示时， 或者在用户代理呈现自动安装提示之前， 会分派 {{BeforeInstallPromptEvent}}。它允许站点取消 自动安装提示，并手动呈现 站点触发的安装提示。

PromptResponseObject 包含调用 {{BeforeInstallPromptEvent/prompt()}} 的结果。它包含一个成员， userChoice， 该成员表示用户选择的结果。

{{BeforeInstallPromptEvent}} 实例具有以下内部槽：

[[\didPrompt]]

一个布尔值，初始为 `false`。表示此事件是否已用于向最终用户 呈现安装提示。

[[\userResponsePromise]]

一个 promise，表示呈现安装 提示的结果。

              window.addEventListener("beforeinstallprompt", event => {
                // 抑制自动提示。
                event.preventDefault();

                // 显示（默认禁用的）安装按钮。此按钮在点击时
                // 解析 installButtonClicked promise。
                installButton.disabled = false;

                // 等待用户点击按钮。
                installButton.addEventListener("click", async e => {
                  // prompt() 方法只能使用一次。
                  installButton.disabled = true;

                  // 显示提示。
                  const userChoice = await event.prompt();
                  console.info(`user choice was: ${userChoice}`);
                });
              });
            

对 `Window` 对象的扩展

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