HTML5 Manifest 已被现代浏览器弃用，判断是否生效需检查 Network 中 manifest 请求、applicationCache.status 值（2 表示已缓存）、Cache Storage 是否有条目，并监听 cached/updateready 事件；Chrome 94+ 等已彻底移除支持，应改用 Service Worker + Cache API。
如何判断 HTML5 Manifest 是否生效
Manifest 缓存是否启用，不能只看 manifest 属性是否存在，关键得验证浏览器是否真正下载、解析并应用了清单文件。最直接的判断方式是检查网络请求和 Application Cache API 状态。
- 打开浏览器开发者工具（F12），切换到 Network 面板，刷新页面，观察是否发起对
manifest文件的 GET 请求（状态码应为 200） - 在 Console 中执行
window.applicationCache.status，返回值为1（UNCACHED）说明未启用；2（IDLE）表示已缓存且无更新；3（CHECKING）或4（DOWNLOADING）说明正在检查或更新缓存 - 查看 Application > Cache Storage（Chrome）或 Resources > Application Cache（旧版 Safari/Firefox）中是否有对应 origin 的缓存条目
常见 Manifest 不生效的典型原因
即使写了 manifest="app.manifest"，也极大概率不工作——HTML5 AppCache 已被现代浏览器逐步弃用，且对路径、MIME 类型、HTTPS 等极为敏感。
-
manifest文件必须返回text/cache-manifestMIME 类型，Nginx/Apache 需显式配置（例如 Apache：AddType text/cache-manifest .manifest） - 清单文件路径必须与 HTML 页面同源，且相对路径以页面为基准解析（
manifest="cache.manifest"是相对于 HTML URL，不是当前目录） - 清单文件第一行必须是
CACHE MANIFEST（严格大小写，无 BOM，无空格前缀） - HTTP 环境下，若页面通过
file://打开，AppCache 完全禁用；HTTPS 下部分浏览器（如 Chrome 94+）已彻底移除支持
用 JavaScript 监听 Manifest 生命周期事件
靠手动刷 Network 面板太被动，用事件监听才能确认实际行为。注意：这些事件仅在 AppCache 启用且解析成功后触发。
if (window.applicationCache) {
const appCache = window.applicationCache;
appCache.addEventListener('cached', () => console.log('缓存完成'));
appCache.addEventListener('updateready', () => {
if (appCache.status === appCache.UPDATEREADY) {
appCache.swapCache(); // 切换到新缓存
location.reload();
}
});
appCache.addEventListener('error', (e) => console.error('AppCache error:', e));
}
- 事件只在
status为1以外时才可能触发；若始终是1，说明根本没加载 manifest -
checking事件触发，代表浏览器已成功获取 manifest 并开始比对；没这个事件，基本可断定 manifest 路径错、404 或 MIME 错 - Chrome 94+、Firefox 85+、Safari 16.4+ 已移除
window.applicationCache，调用会报ReferenceError
替代方案比修复 Manifest 更现实
Manifest 缓存机制已被标准废弃，W3C 已将其标记为 obsolete。现在判断“是否离线可用”，应该转向 Service Worker + Cache API。
立即学习“前端免费学习笔记（深入）”；
- 检测 Service Worker 是否注册成功：
navigator.serviceWorker.controller !== null（控制当前页面）或registration.active（已激活） - 检查资源是否命中 Cache API：
await caches.match('/index.html')返回 Response 对象即表示已缓存 - Manifest 的离线 fallback 逻辑（如
FALLBACK:段）无法在 Service Worker 中直接复现，需在fetch事件里手动实现
真正需要离线能力时，别花时间 debug Manifest 的 404 或 MIME 错误——它在绝大多数新项目里已经不是“能不能用”的问题，而是“根本不被支持”的事实。
