跳转到内容

接收分享的内容(share target)

发布于 更新于

share_target 清单成员让已安装的 PWA 出现在系统分享面板中,接收其他应用分享的内容。照片会以 File 形式交给页面,供你预览和导入。Web App Manifest 声明接收 URL 后,浏览器就会像提交表单一样向它发送 GET 或 POST 请求。

你需要一个带 Service Worker 的可安装 PWA(见让它可安装);在所有平台上, 分享面板都只在用户安装之后才列出 Web 应用。每个 manifest 只允许一个 share_target,所以不同类型的分享 在接收页面上分流。

必须填写 action 和 params。action 指定接收 URL,须位于 manifest 的 scope 内;params 把分享字段映射到请求参数名。 method 默认为 GET,enctype 默认为 application/x-www-form-urlencoded。接收文件要求 POST 配合 multipart/form-data,并提供一个 files 数组,每一项写明字段名与接受的 MIME 类型或扩展名;两种写法都列上, 因为各操作系统匹配的方式不同。

{
"name": "Scrapbook",
"start_url": "/",
"display": "standalone",
"share_target": {
"action": "/share",
"method": "POST",
"enctype": "multipart/form-data",
"params": {
"title": "title",
"text": "text",
"url": "url",
"files": [{ "name": "media", "accept": ["image/*", ".png", ".jpg", "video/*"] }]
}
}
}

纯文本目标可以保留 GET 默认值:浏览器以 ?title=…&text=…&url=… 打开 action,页面读取 new URL(location).searchParams。GET 更容易调试,但会把分享的文本泄露到历史记录与服务器日志里; POST 把它放在请求体中,而且是接收文件的唯一方式。

页面读不到 POST 请求体,所以由 Service Worker 在 fetch 中拦截请求、读取 formData()、保存文件, 然后以 303 See Other 重定向到展示它们的页面。重定向能避免刷新页面时重复提交分享。 重定向目标带一个标记(?shared=1),页面据此知道要去缓存里找。

sw.js
self.addEventListener('fetch', (event) => {
const url = new URL(event.request.url);
if (event.request.method !== 'POST' || url.pathname !== '/share') return;
event.respondWith(
(async () => {
const formData = await event.request.formData();
const files = formData.getAll('media');
const cache = await caches.open('shared-content');
await Promise.all(files.map((file, i) => cache.put(`/shared/${i}`, new Response(file))));
const text = formData.get('text') || formData.get('url') || '';
return Response.redirect(`/share/view?shared=1&text=${encodeURIComponent(text)}`, 303);
})(),
);
});

像对待任何表单提交一样校验收到的内容:别的应用会把内容放进意料之外的参数,而请求体来自你无法控制的软件。

重定向后的页面先检查标记,再把保存的响应读成 Blob,显示给用户确认,随后删除,以免下次分享读到上一次的文件。不带标记直接打开 /share/view 时渲染正常视图。

function isSharedLaunch() {
return new URLSearchParams(location.search).has('shared');
}
async function takeSharedFiles() {
if (!('caches' in window)) return [];
const cache = await caches.open('shared-content');
const requests = await cache.keys();
const files = await Promise.all(requests.map((request) => cache.match(request).then((r) => r.blob())));
await Promise.all(requests.map((request) => cache.delete(request)));
return files;
}
if (isSharedLaunch()) {
takeSharedFiles().then(renderSharedFiles);
} else {
renderDefaultView();
}

从浏览器的 Install(英文界面)入口安装 PWA,打开任意相册应用,选择 Share,在系统面板中选中你的 应用名。重定向落到 /share/view,预览图由缓存的文件渲染出来。再从浏览器分享一个 URL,就能看到 Android 上 text 回退的实际效果。浏览器对已安装 Web 应用的分享接收支持如下。

  • 图例
  • 支持
  • 部分支持
  • 需开启标志
  • 不支持
  • 未知
浏览器 / 平台支持版本置信度来源备注
Chrome (Desktop)#支持89高来源—
Chrome (Android)#支持76高来源—
Edge (Desktop)#支持89高来源1
Firefox (Desktop)#不支持—高来源2
Firefox (Android)#不支持—高来源3
Safari (macOS)#不支持—高来源4
Safari (iOS)#不支持—高来源56
Samsung Internet#支持12.0高来源7
WebView (Android)#不支持—高来源8
  1. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  2. 实现跟踪:https://bugzil.la/1476515。
  3. 该属性可以解析,但没有任何效果。
  4. 实现跟踪:https://webkit.org/b/194593。
  5. 实现跟踪:https://webkit.org/b/194593。
  6. 由 browser-compat-data 镜像自 Safari 的数据推导。
  7. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
  8. browser-compat-data 未记录 WebView Android 的支持。

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

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

← 返回指南总览。