html制作file_handlers文件关联_html PWA file_handlers文件类型关联【实战】-html教程-PHP中文网

file handling api无法使pwa自动成为系统默认程序，仅支持用户手动在系统设置中指定后响应文件打开请求；需严格配置manifest.json的file_handlers、通过launchqueue处理文件，且仅chromium桌面版稳定支持。

html制作file_handlers文件关联_html pwa file_handlers文件类型关联【实战】

File Handling API 不能让你的 PWA 自动变成系统默认程序，它只负责“被选中后正确响应”——用户必须手动在 Windows 设置或 macOS 右键菜单里点一次“用此应用打开”，后续双击才会触发你的 launchQueue。

浏览器只在解析 manifest.json 时读取 file_handlers，错一个字段就完全失效。常见问题包括：

action 值必须是相对根路径（如 "/open"），不能写成 "open.html" 或带协议的绝对 URL
accept 中的 MIME 类型键支持通配符（如 "image/*"），但实际匹配依赖操作系统上报的类型——Windows 把 .heic 报成 image/heic，而 Chrome 当前不认这个，只能显式写 {"image/heic": [".heic"]}
同一 accept 对象里混写不兼容类型（比如 {"text/plain": [".txt"], "application/json": [".json"]}）语法合法，但部分系统会忽略后项
manifest.json 必须通过 <link rel="manifest" href="/manifest.json"> 显式声明，且服务器返回 MIME 类型为 application/manifest+json

用户双击文件 → 系统拉起已安装 PWA → 浏览器新开一个上下文执行 JS，此时 launchQueue 才可用。它不会出现在普通刷新、导航或 Service Worker 激活中。

html-deploy

使用 htmlcode.fun 将 HTML 内容或文件部署到网页，适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。

下载

别在 DOMContentLoaded 或 window.onload 里检查 'launchQueue' in window——这时候一定为 false
重复调用 launchQueue.setConsumer() 不会报错，但第二次及之后的调用被静默忽略，导致后续文件无法处理
file 是 FileSystemHandle，不是 Blob；必须先 await file.getFile() 才能读内容，否则抛 TypeError: getFile is not a function
launchParams.files 只存在于 setConsumer 回调参数里，其他地方访问是 undefined

Firefox 和 Safari 完全不支持 file_handlers 和 launchQueue；Android 和 iOS 的 PWA 也不支持——这是纯桌面 Chromium 特性。

即使 manifest 配置正确，用 Chrome for Android 打开 .txt 文件，也不会触发你的 PWA
Windows 上测试需确保：PWA 已通过 Chrome/Edge “安装为应用”，且在系统设置中手动设为某扩展名的默认程序
macOS 上需右键文件 → “显示简介” → “打开方式”选你的 PWA → 点“全部更改”，否则双击无反应
开发调试时，可临时用命令行启动 Chrome 并强制启用实验性支持：chrome --unsafely-treat-insecure-origin-as-secure="http://localhost:8080" --user-data-dir=/tmp/chrome-test --unsafely-allow-automation（仅限本地开发）

最容易被忽略的是：file_handlers 生效的前提不是代码写对了，而是用户已在系统层面完成一次“信任授权”。没有这一步，所有 JS 逻辑都永远不会运行——它不像 fetch 或 localStorage 那样只要代码存在就能触发，而更像一个需要操作系统盖章的门禁卡。