跳转到内容

Manifest 中的清单成员

id 清单成员

发布于

有限可用不支持的浏览器: Firefox (Desktop)、Firefox (Android)W3C

清单成员 id 用来标识 Web 应用,让身份独立于启动 URL。没有这个成员时,浏览器通常用 start_url 等值确定身份;启动 URL 一变,清单就代表新的应用,新旧安装会并存。设置 id 后,修改 start_url 不会改变应用身份。

Chrome 96、Edge 96、Samsung Internet 17.0、iOS 上的 Safari 16.4 以及 macOS 上的 Safari 17 处理该 成员(BCD manifests.webapp.id)。Firefox 会解析该属性,但它不起作用(BCD 说明)。忽略 id 的浏览器沿用原先的身份规则,所以加上该成员不会破坏其他平台上的安装。

属性 值
类型 字符串,相对 start_url 的源按 URL 解析。浏览器拒绝解析到其他源的值;Chromium 记录 property 'id' ignored, should be same origin as document. 并退回默认值。
默认值 解析后的 start_url。id 缺失、为空或无法解析时,身份就与启动 URL 绑在一起,设置有效的成员值才能解除这种绑定。
示例值 "/?homescreen=1",对 https://example.com 上的应用解析为 https://example.com/?homescreen=1。

处理清单时,解析后的值会与每个已安装应用的身份比较。匹配意味着“更新这个应用”;不匹配意味着“新 应用”。比较的是完整解析后的 URL,所以 "/" 与 "/?v=2" 是两个不同的应用,值应当选定一次后不再 动。Chromium 对已安装应用每天检查一次更新,多数字段的改动要等该应用的所有窗口关闭后才应用 (web.dev,“How Chrome handles updates to the web app manifest”);只有 id 存在且未变时,改动 start_url 才算更新。

navigator.getInstalledRelatedApps() 读不到 id:它报告相关的原生应用,以及(Chrome 80+)在 related_applications 中以 platform: "webapp" 列出的 PWA,匹配时只看清单 URL,不读取 id。

首次发布前先设好 id。已经发布的应用如果没有 id,先找回现有身份,再填入这个成员。

用较短的根相对路径即可;该成员相对 start_url 的源解析,写上协议和主机没有意义。启动 URL 带 着分析参数,以后可以改而不触及身份。

{
"name": "Ledger",
"id": "/",
"start_url": "/app/?source=pwa",
"scope": "/app/",
"display": "standalone"
}

Chrome 96+ 与 Safari 16.4+ 把身份记录为 https://example.com/;之后一份 "start_url": "/dashboard/?source=pwa" 的清单会更新已安装的应用,不会增加安装副本。

身份固定后,改动启动路径的改版只需编辑 start_url 与 scope。身份那一行是不能动的。

{
"name": "Ledger",
"id": "/",
"start_url": "/home/",
"scope": "/",
"display": "standalone"
}

在 Chrome 155 上,已安装应用在下一次每日清单检查时拿到新的 start_url,并在应用窗口全部关闭 后应用它;在忽略 id 的浏览器上,只要该浏览器此前没用过 start_url 当身份键,同样的改动也能正常 工作。

在声明 id 之前安装的应用,其身份是 Chromium 从 start_url 算出来的。要保留现有安装,把 id 设为 DevTools 显示的精确值。这个脚本读取页面链接的清单,打印出可复制的值;抓取失败时给出提示。

async function suggestedId() {
const link = document.querySelector('link[rel="manifest"]');
if (!link || !('fetch' in window)) return null; // 没有可检查的东西。
const manifest = await fetch(link.href).then((r) => r.json()).catch(() => null);
if (!manifest) return null;
if (manifest.id) return new URL(manifest.id, location.origin).href;
return new URL(manifest.start_url ?? '/', link.href).href; // Chromium 的默认身份。
}
const id = await suggestedId();
console.log(id ? `Set "id" to ${new URL(id).pathname + new URL(id).search}` : 'Manifest not readable');

对 "start_url": "/app/?source=pwa",打印出的值是 /app/?source=pwa;把这个字符串声明为 id 就冻结了现有用户已经拥有的身份,此后 start_url 可以自由更改。

规范

规范状态
Web 应用清单:idW3C
Web Application Manifest: start_url memberW3C
  • 图例
  • 支持
  • 部分支持
  • 需开启标志
  • 不支持
  • 未知
浏览器 / 平台支持版本置信度来源备注
Chrome (Desktop)#支持96高来源—
Chrome (Android)#支持96高来源1
Edge (Desktop)#支持96高来源2
Firefox (Desktop)#不支持—高来源3
Firefox (Android)#不支持—高来源4
Safari (macOS)#支持17高来源—
Safari (iOS)#支持16.4高来源—
Samsung Internet#支持17.0高来源5
WebView (Android)#支持96高来源6
  1. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  2. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  3. 该属性可以解析,但没有任何效果。
  4. browser-compat-data 未记录 Firefox for Android 的支持。
  5. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
  6. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。

源数据: /compatibility/manifest-id.json · 全球使用占比: 93 % (StatCounter 2026-09, CC BY-SA 4.0)

来源: 规范 · MDN · 最近核验 2026-10-03 · 置信度: 高 (由来源计算)