deletedatabase 是 indexeddb 用于异步删除整个数据库的原生方法,需通过 success/error/blocked 事件处理结果,并确保无活跃连接。

deleteDatabase 是 IndexedDB 提供的原生方法,用于异步删除整个数据库(包括所有对象存储、索引和数据)。它不会立即执行,而是返回一个 IDBRequest 对象,通过监听 success 或 error 事件来确认结果。
基本用法:调用 deleteDatabase 并处理响应
只需传入数据库名即可发起删除请求。注意:如果该数据库当前被其他连接打开(例如页面中还有活跃的 IDBDatabase 实例),删除会等待这些连接关闭后才真正执行。
- 调用
window.indexedDB.deleteDatabase("myDB")启动删除流程 - 监听
onsuccess事件表示数据库已成功排队删除(或已清空) - 监听
onerror可捕获权限问题、无效名称或浏览器限制等错误 - 可选监听
onblocked—— 当有其他连接正在使用该库时触发,说明删除被阻塞
处理 blocked 场景:确保无活跃连接
常见问题是删除未生效,实际是因为页面中仍有未 close 的数据库连接(比如忘记调用 db.close() 的事务或打开操作)。此时 onblocked 会被触发。
- 在
onblocked回调中,可提示用户刷新页面,或主动关闭已知连接 - 推荐做法:在调用
deleteDatabase前,检查并显式关闭所有已打开的IDBDatabase实例 - 注意:无法强制终止其他标签页中的连接,只能等待或引导用户手动干预
完整示例代码(含错误与阻塞处理)
以下是一个健壮的删除封装:
function clearDatabase(dbName) {
const req = indexedDB.deleteDatabase(dbName);
req.onsuccess = () => {
console.log(`数据库 "${dbName}" 已删除`);
};
req.onerror = () => {
console.error("删除数据库失败:", req.error);
};
req.onblocked = () => {
console.warn(`数据库 "${dbName}" 正被使用,删除被阻塞`);
alert("请关闭其他使用该数据库的页面标签,然后重试");
};
}
// 调用
clearDatabase("userPreferences");
注意事项与常见误区
- 数据库名区分大小写,必须与创建时完全一致(包括空格)
- 删除是异步的,不能用 return 值判断结果,必须依赖事件
- Chrome DevTools 的 Application → Storage 面板中,删除后可能需手动刷新“IndexedDB”列表才能看到变化
- 某些旧版浏览器(如 IE)不支持 IndexedDB,deleteDatabase 也不存在,建议先检测
window.indexedDB
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











