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

《夸克》非常好用的免费AI浏览器

下载APP查看