怎么通过HTML的Storage Manager API查询浏览器存储配额使用情况-html教程-PHP中文网

navigator.storage.estimate() 必须在安全上下文中异步调用，返回 usage 和 quota 的估算值，quota 动态变化且非精确，需结合 persist() 提升稳定性并避免依赖其绝对数值。

怎么通过html的storage manager api查询浏览器存储配额使用情况

直接调用 `navigator.storage.estimate()` 获取 usage 和 quota

必须在安全上下文（https:// 或 localhost）中执行，否则 navigator.storage 为 undefined，调用会抛出 TypeError。该方法返回 Promise，不能同步读取：

if ('storage' in navigator && 'estimate' in navigator.storage) {
  navigator.storage.estimate().then(({ usage, quota }) => {
    console.log('已用:', usage, '字节');
    console.log('估算配额:', quota, '字节');
    console.log('剩余估算:', quota - usage, '字节');
  }).catch(err => {
    console.warn('estimate 失败:', err.name); // 常见 NetworkError / SecurityError / TypeError
  });
}

不要在页面加载初期（如 DOMContentLoaded 触发前）就调用——等用户有交互（如点击按钮）后再执行，Chrome 在无用户手势时可能返回 quota: 0
usage 是当前 origin 所有持久化存储（IndexedDB、Cache API、localStorage 等）的压缩后总占用，不是原始字节数
quota 是软上限，非磁盘级精确值：Chrome 桌面可达 GB 级，Android WebView 可能仅几百 MB，Safari 17.5 仍返回 {usage: 0, quota: 0}

为什么 `quota` 经常是 0 或远高于实际可用空间

这不是 bug，而是设计使然：quota 是浏览器根据空闲磁盘、内存、用户活跃度、是否安装为 PWA 等动态估算的结果，不是固定配额。

Chrome 中未触发“高信任上下文”（如无用户手势、无 Storage Access API 授权）时，quota 常为 0
Safari 长期不支持该 API，即使存在也返回 0，不能用于判断容量压力
隐身/无痕模式下，Chrome 默认配额约 128–1500 MB（非固定），Firefox 更保守，usage 可能为 0
不要用 quota - usage 做精确写入判断；更适合看比值，例如 usage / quota > 0.85 表示高风险

结合 `navigator.storage.persist()` 提升配额稳定性

对 PWA 或需长期缓存的 Web 应用，可主动请求持久化权限，部分浏览器会在授权后返回更高、更稳定的 quota 值。

page-agent 浏览器控制（CDP）

使用 page-agent CLI（CDP）控制浏览器；CLI只能通过 GitHub Release 的 .tgz 安装，npm 官方包暂未发布。

下载

navigator.storage.persist().then(granted => {
  if (granted) {
    console.log('已获持久化授权');
  } else {
    console.log('用户拒绝或未弹出提示');
  }
  return navigator.storage.estimate();
}).then(({ usage, quota }) => {
  console.log(`持久化后配额: ${quota} 字节`);
});