launchQueue 不是 HTML 标签或 DOM API，仅在 PWA 被系统以文件关联方式启动时存在，必须通过 launchQueue.setConsumer() 注册回调才能获取文件句柄；普通刷新、导航或 Service Worker 激活时均不可用，且重复调用 setConsumer 仅首次生效。
launchQueue 不是 HTML 标签或 DOM API，它只在 PWA 被系统以文件关联方式启动时存在，且必须通过 launchQueue.setConsumer() 注册回调才能拿到文件句柄——普通页面刷新、DOMContentLoaded 或 window.onload 里检查它，永远是 undefined。
launchQueue 只在 OS 启动上下文中可用
用户双击一个被关联的文件（比如 .json）→ 系统唤起已安装的 PWA → 浏览器新开一个干净的渲染进程执行你的 JS，此时 launchQueue 才被注入全局作用域。它不会出现在：
- 手动访问
/open页面时 - Service Worker 激活或更新期间
- 点击网页内链接跳转后
-
location.reload()或 F5 刷新后
所以检测逻辑必须写成：if ('launchQueue' in window) { launchQueue.setConsumer(...); }，而不是等某个事件再判断。
setConsumer 回调里必须 await file.getFile()
launchParams.files 是 FileSystemHandle[] 数组，不是 Blob 或 File 对象。直接读取 file.name 或 file.size 没问题，但要读内容必须先调用 getFile()：
立即学习“前端免费学习笔记（深入）”；
launchQueue.setConsumer(async (launchParams) => {
const files = launchParams.files || [];
if (files.length === 0) return;
// ✅ 正确：await getFile() 得到 File 对象
const file = await files[0].getFile();
const content = await file.text(); // 或 arrayBuffer(), slice() 等
// ❌ 错误：file.text() 会报 TypeError
// file.text(); // Uncaught TypeError: file.text is not a function
});
常见错误还包括忘记 async 就直接 await，或在非 setConsumer 回调里尝试访问 launchParams.files —— 那里它始终是 undefined。
重复调用 setConsumer 会被静默忽略
同一个页面生命周期内，多次调用 launchQueue.setConsumer() 只有第一次生效，后续调用不报错也不覆盖。这会导致：
- 热更新 JS 后没重新注册 consumer，新文件打不开
- SPA 路由切换时误在不同组件里重复注册
- 开发中反复刷新调试页，以为新逻辑已生效，实际还在跑旧回调
建议把注册逻辑放在入口 JS 最顶层（如 index.js 开头），加个标记防止意外重入：if (!window.__launched) { launchQueue.setConsumer(...); window.__launched = true; }。
accept MIME 类型不匹配会导致 files 为空
即使 manifest.json 里写了 "accept": {"text/plain": [".txt"]}，如果操作系统上报的 MIME 类型是 application/octet-stream（常见于 Windows 未注册扩展名时），Chrome 就不会把该文件传进 launchParams.files。
验证方法：
- 在
setConsumer回调开头加console.log(launchParams)，确认files是否为[] - 用真实文件双击测试，别只靠改 URL 参数模拟
- Windows 上可右键 → “属性” 查看“类型”字段；macOS 可用
file -I filename命令查实际 MIME
遇到空 files，优先检查 manifest.json 的 accept 键是否与系统报告类型一致，而不是怀疑 JS 逻辑。
真正容易被忽略的是：launchQueue 不提供取消、重试或错误恢复机制。一旦回调开始执行，出错就只能靠你自己捕获 try/catch 并降级处理 —— 比如文件损坏时 fallback 到提示用户重新选择。
