clearStorage API 不清除 localStorage 是因为 chrome.storage.local 与 localStorage 互不隶属；需用 localStorage.clear() 或 chrome.scripting.executeScript 注入执行，且 browsingData.remove 在 Chrome 94+ 已移除 localStorage 类型支持。
clearStorage API 清除全部缓存时为什么没清掉 localStorage？
因为 chrome.storage.local 和 localStorage 是两套完全独立的存储机制，chrome.runtime.clearStorage（或 chrome.browsingData.remove）默认不触碰页面级的 localStorage。很多开发者调用 chrome.browsingData.remove({since: 0}, ['cache', 'cookies']) 后发现页面刷新还在读旧数据，问题就出在这里。
实操建议：
- 要清
localStorage，必须在目标页面上下文中执行localStorage.clear()，比如通过chrome.scripting.executeScript注入脚本 -
chrome.browsingData.remove的types参数里没有localStorage—— 它只支持['appcache', 'cache', 'cookies', 'downloads', 'fileSystems', 'formData', 'history', 'indexedDB', 'localStorage', 'pluginData', 'passwords', 'serviceWorkers', 'webSQL']，但注意：Chrome 94+ 已将localStorage从该列表中移除，实际行为取决于 Chrome 版本和站点权限（是否为“受保护站点”） - 若目标是清除扩展自身写入的
chrome.storage.local，直接用chrome.storage.local.clear()即可，无需走 browsingData
隐私模式（Incognito）下 extension 默认不运行，怎么让它生效？
Chrome 默认禁止扩展在隐私窗口运行，所以即使你写了清除逻辑，在隐私模式打开的页面里根本不会执行 —— 这不是代码问题，是权限开关没开。
实操建议：
- 进
chrome://extensions，找到你的扩展，勾选右上角的Allow in incognito - 如果扩展用到了
chrome.webRequest或需要拦截请求，还需在 manifest.json 中声明"incognito": "split"或"incognito": "spanning"（后者已废弃，推荐前者） - 注意：即使开了权限，
chrome.storage.session在隐私窗口关闭后自动清空，而chrome.storage.local不会 —— 所以不要依赖它做“临时状态”
一键清除所有前端存储的最小可行脚本
适用于调试场景：想立刻抹掉当前页面所有持久化数据，包括 localStorage、sessionStorage、indexedDB、cache，且不依赖扩展。
实操建议（复制到控制台直接运行）：
(() => {
localStorage.clear();
sessionStorage.clear();
caches.keys().then(keys => Promise.all(keys.map(key => caches.delete(key))));
indexedDB.databases().then(dbs => dbs.forEach(db => indexedDB.deleteDatabase(db.name)));
})();注意点：
-
caches.delete()是异步的，控制台里看不到立即反馈，可用caches.keys()验证是否清空 -
indexedDB.databases()在 Safari 和部分旧版 Chrome 中不可用，稳妥做法是提前记下数据库名，用indexedDB.deleteDatabase('xxx')显式删 - Service Worker 缓存（
self.caches）只能在 SW 线程中清除，上面脚本无法触达；需先navigator.serviceWorker.getRegistrations()然后registration.unregister()再 reload
chrome.browsingData.remove 调用失败的常见报错与绕过方式
典型错误是 Unchecked runtime.lastError: Cannot remove browsing data of type 'cache' in incognito mode，或者静默失败无响应。
原因和对策：
- 权限缺失：manifest.json 必须声明
"permissions": ["browsingData"]，且用户首次安装时会提示，不能动态申请 - 隐私模式限制：Chrome 禁止在隐私窗口中清除 cache / history 等数据，
browsingData.remove会直接报错；此时应降级为只清扩展自己的storage和注入脚本清页面存储 - 跨源限制：无法清除第三方域名的
localStorage（同源策略），哪怕你有host_permissions；能操作的只有当前 tab 的document.origin对应域 - 时间范围陷阱：传
{since: 0}理论上清全部，但某些版本对since值校验严格，建议用Date.now() - 30 * 24 * 60 * 60 * 1000（30天前）更稳
真正难处理的是混合存储场景：一个功能同时用了 localStorage、indexedDB、Cache API 和 chrome.storage，而用户又在隐私模式下操作。这时候没有银弹，得按存储类型分路径清理，且每种都有生命周期和作用域边界——漏掉任意一层，都会让“已清除”变成假象。
