share_target 是 PWA 接收系统分享的唯一必需配置，必须在 manifest.json 中完整声明 action、method、enctype 和 params 字段，并配合已激活的 Service Worker 拦截处理 POST 请求，缺一不可。
share_target 是 manifest.json 中唯一能让 PWA 接收系统级分享内容的配置项。它不是可选增强，而是硬性前置——没它，PWA 在 Windows 或 Android 上根本不会出现在系统分享目标列表里。
share_target 必须和 service worker 联动才能生效
仅在 manifest.json 里写 share_target 不会自动接收数据；浏览器必须通过已激活的 Service Worker 拦截并处理传入的分享请求。这意味着：
-
share_target声明只是“注册意图”，真正解析 URL/text/files 的逻辑必须写在 Service Worker 的fetch事件中（监听POST到指定action路径的请求） - Service Worker 文件（如
sw.js）需在页面加载时成功注册，且状态为active（可在 Chrome DevTools > Application > Service Workers 查看） - 若
share_target.action指向/share，那sw.js里必须有对应路由处理，否则请求 404，系统直接丢弃分享
share_target 的字段不能只填 action
常见错误是只写 "action": "/share"，结果在 Windows 设置里看不到应用、Android 分享菜单也不出现。完整必需字段包括：
-
action：必须是相对路径（如"/share"），且该路径要能被 Service Worker 拦截；不能是绝对 URL 或带查询参数 -
method：固定为"POST"（规范强制，填 GET 会被忽略） -
enctype：必须是"multipart/form-data"（即使只收 text/url，系统也按此编码发） -
params：对象，至少含url、text、title三者之一；例如{"url": "link", "text": "content"}—— 这些 key 将作为表单字段名出现在 POST 请求体中
漏掉任意一项，manifest.json 加载虽不报错，但 share_target 功能整体失效。
立即学习“前端免费学习笔记（深入）”；
Windows 和 Android 对 share_target 的兼容差异
同一份 manifest.json，在不同平台表现可能不一致，关键点在于：
- Windows（Edge/Chrome on Win11+）：严格校验
enctype和method，且要求 PWA 已通过“添加到开始菜单”安装（未安装的网页不会出现在分享目标中） - Android（Chrome）：对
params宽松些，但若icons缺少 192×192 PNG，或start_url返回 302 重定向，整个 PWA 可能不被识别为可安装应用，连带share_target不生效 - 两者都要求 HTTPS；localhost 开发时 Chrome 允许，但 Edge on Windows 可能拒绝注册为共享目标，建议用
https://localhost或本地证书
调试 share_target 的实际请求流
用户从其他 App 分享内容到你的 PWA 后，真实链路是：系统 → 浏览器 → 启动 PWA → 发起 POST 到 share_target.action → Service Worker 拦截 → 解析 FormData。验证是否走通，最直接方式是：
- 在
sw.js的fetch事件中加console.log(event.request.url)，确认是否命中/share - 用
event.request.formData()获取数据，再.get('text')或.get('url')—— 注意：不能用URLSearchParams，因为 enctype 是multipart/form-data - 若 FormData 为空，大概率是
params字段名和实际发送的不匹配（比如 manifest 写"text": "body"，但代码里却.get('text')）
这个环节没有浏览器 DevTools 的 Network 面板可见请求（因由系统发起），所有日志只能打在 Service Worker 控制台里，容易误判为“没触发”。
