如何通过HTML的manifest.json的share_target配置PWA接收系统分享的能力-html教程-PHP中文网

share_target 是 pwa 接收系统分享的唯一必需配置，必须在 manifest.json 中完整声明 action、method、enctype 和 params 字段，并配合已激活的 service worker 拦截处理 post 请求，缺一不可。

如何通过html的manifest.json的share_target配置pwa接收系统分享的能力

share_target 是 manifest.json 中唯一能让 PWA 接收系统级分享内容的配置项。它不是可选增强，而是硬性前置——没它，PWA 在 Windows 或 Android 上根本不会出现在系统分享目标列表里。

仅在 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，系统直接丢弃分享

常见错误是只写 "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 功能整体失效。

Browser Js

轻量级CDP浏览器控制，适用于AI代理。相较于内置浏览器工具，token消耗降低3‑10倍，仅在浏览时使用。

下载

同一份 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 或本地证书

用户从其他 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')）