id

语法

/* Absolute URL */
"id": "https://example.com/myapp"

/* Relative URL */
"id": "myapp/v2"

/* URL with query parameters */
"id": "myapp?version=2&mode=trial"

值

id

一个字符串，形式为一个 URL。该 URL 必须与您 Web 应用程序的 start_url 同源。如果 id 是一个相对 URL，它将使用 start_url 的源进行解析。id 中的任何片段始终会被忽略。如果 id 未指定，或者其值在任何方面无效（例如，不是字符串、不是有效 URL、与 start_url 不同源），则将使用 start_url 的值。

描述

id 清单成员用作您 Web 应用程序的唯一标识符。它允许浏览器区分不同的应用程序。

• 当浏览器遇到一个 id 与已安装应用程序不匹配的应用清单时，它会将该清单视为一个独立应用程序的描述，即使它与另一个应用程序由相同的 URL 提供服务。
• 当浏览器遇到一个 id 与已安装应用程序的标识匹配的应用清单时，它会将新清单视为现有应用程序清单的替代，即使该应用程序提供的 URL 与之前安装的 URL 不同。

id 还可以被收集 Web 应用列表的服务用来唯一标识应用程序。

用法说明

使用 id 成员时需要记住的几个要点：

• 作为推荐实践，请使用前导 / 来指定 id 是一个根相对 URL 路径。
• 由于 id 是相对于 start_url 的源解析的，因此 id 值如 ../foo、foo、/foo 和 ./foo 相对于源都会解析为相同的标识符。例如，如果 start_url 是 https://example.com/app/，所有这些 id 值都将解析为 https://example.com/foo/。
• 标准 URL 编码和解码规则适用于解析 id 值。
• id 中的片段在处理过程中会被移除。例如，如果 id 设置为 foo#bar，它将被解析为 foo。同样，如果 id 未定义，并且 start_url 为 https://example.com/app/#home，id 将解析为 https://example.com/app/。
• id 中的查询参数会被保留并包含在最终解析的标识符中。

理解 id 解析

假设您应用程序的 start_url 是 https://example.com/my-app/home。下表演示了清单中不同的 id 值将如何解析：

示例

创建不同的应用版本

假设您创建了一个具有以下清单的 Web 应用程序：

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/v1",
  "start_url": "https://example.com/app"
}

如果您稍后创建此应用程序的另一个版本，并进行了重大更改，希望将其视为一个不同的应用程序，您可以这样添加清单：

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/v2",
  "start_url": "https://example.com/app"
}

在这种情况下，即使两个清单文件都由相同的 URL 提供服务，浏览器也会将新清单视为一个独立应用程序的描述，因为 id 是不同的。因此，用户可以同时安装这两个版本。

更新现有应用

考虑一种场景，您部署了一个具有以下清单的 Web 应用程序：

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/",
  "start_url": "https://example.com/old-app"
}

但是，您后来决定将应用程序移动到不同的路径。然后，您将更新清单如下：

{
  "name": "My Weather Application",
  "id": "https://example.com/weatherapp/",
  "start_url": "https://example.com/new-app"
}

浏览器会将此新清单视为对现有应用程序的更新，因为 id 值匹配。在这种情况下，用户将收到其现有应用程序的更新，而不是被提示安装一个新应用程序。

规范

浏览器兼容性

另见

• scope manifest 成员
• start_url manifest member