Declarative Link Capturing：PWA 链接捕获与页面合并

---

title: Declarative Link Capturing：PWA 链接捕获与页面合并

keywords:

• Link Capturing
• launch_handler
• URL Handling
• 多窗口策略
• PWA

description: 说明 Declarative Link Capturing 的 Manifest 配置与行为，在已安装 PWA 中捕获外部链接并合并到现有窗口，改善会话连续性与

UX。

categories:

• 应用软件
• 视频软件

---

概述

Declarative Link Capturing 允许 PWA 在系统打开相关链接时，将导航捕获并在现有应用窗口中处理，避免打开多个实例，提升会话连贯性。

Manifest 片段（示例）

{
  "launch_handler": {
    "route_to": "existing-client",
    "navigate_existing_client": "always"
  },
  "protocol_handlers": [{ "protocol": "web+example", "url": "/handle?url=%s" }]
}

工程建议

• 会话管理：合并到现有窗口时保留状态与路由；处理多窗口策略与用户预期。
• 兼容：在不支持平台回退到常规打开；提供手动合并入口。
• 监控：记录捕获命中率与失败；评估对用户行为的影响。

参考与验证

• Chrome 平台文档（Link Capturing）：https://developer.chrome.com/docs/web-platform/link-capturing/
• web.dev PWA 链接捕获指南：https://web.dev/articles/declarative-link-capturing