一文读懂IndexedDB: 前端本地数据库入门与实践

在前端开发中,我们会遇到这样的问题:

  • 需要在浏览器中存储大量结构化数据
  • localStorage 空间太小,性能太差
  • 需要支持索引,事务,复杂查询
  • 希望数据能离线可用

这时候,indexedDB 就是最合适的选择

本文将带你系统了解:

  • indexedDB 是什么
  • 它能解决什么问题
  • 核心概念与基本用法
  • 实际使用中的注意事项

一 。 indexedDB 是什么

indexedDB 是浏览器内置的一种低层级NoSQL 数据库

它具有以下特点

  • 存储在浏览器本地
  • 支持大量数据(通常是MB - GB级)
  • 支持索引(index)
  • 支持事务(Transaction)
  • 异步API,不阻塞主线程

一句话总结:

indexedDB = 浏览器里的本地数据库

二. 为什么不用localStorage?

特性 localStorage IndexedDB
存储容量 ~5MB 几十 MB 甚至 GB
数据类型 字符串 任意 JS 对象
是否异步 ❌ 同步 ✅ 异步
索引 ❌ ✅
事务 ❌ ✅
查询能力 ❌ ✅

结论:

localStorage适合少量简单数据

indexedDB适合复杂,长期,本地数据存储

三. indexedDB 的核心概念

indexedDB 的概念和数据库很像,但名字略有不同

1. 数据库

一个站点(域名)可以创建多个数据库

const request=indexedDB.open('myOB',1);

  • 第一个参数: 数据库名
  • 第二个参数: 版本号(升级用)

2. 对象仓库(Object Store)

可以理解为 表(Table)

db.createObjectStore('users', {

keyPath: 'id'

});


keyPath: 主键字段

每个Object store 存储一类数据

3. 索引(Index)

indexedDB中的index就是索引,用于加速查询

store.createIndex('emailIndex', 'email', { unique: true });

  • 一个Object store 可以有多个index
  • 查询时可以直接走索引

4. 事务

所有读写操作必须在事务中完成

const tx = db.transaction('users', 'readwrite');

const store = tx.objectStore('users');

事务具有:

  • 原子性
  • 自动提交/回滚

四. 基本使用示例

  1. 打开数据库并创建表

const request = indexedDB.open('myDB', 1);

request.onupgradeneeded = event => {

const db = event.target.result;

const store = db.createObjectStore('users', {

keyPath: 'id'

});

store.createIndex('nameIndex', 'name');

};

request.onsuccess = event => {

const db = event.target.result;

console.log('数据库打开成功');

};

  1. 插入数据

const tx = db.transaction('users', 'readwrite');

const store = tx.objectStore('users');

store.add({

id: 1,

name: 'Tom',

age: 20

})

  1. 通过主键查询

store.get(1).onsuccess = e => {

console.log(e.target.result);

};

  1. 通过索引查询

const index = store.index('nameIndex');

index.get('Tom').onsuccess = e => {

console.log(e.target.result);

};

五.indexedDB 适合哪些场景?

非常适合

  • 离线应用(PWA)
  • 本地缓存接口数据
  • 前端日志 / 埋点缓存
  • 大文件分片存储
  • IM / 邮箱 / 草稿箱

不适合

  • 跨浏览器共享数据
  • 需要服务端强一致的数据
  • 简单key-value 少量存储(localStorage更简单)

六. 使用indexedDB 的常见坑

API 过于底层,回调繁琐

indexedDB 原生API 非常啰嗦,实际开发中一般会用封装库:

  • idb (推荐)

import { openDB } from 'idb';

const db = await openDB('myDB', 1, {

upgrade(db) {

db.createObjectStore('users', { keyPath: 'id' });

}

});

七. indexedDB vs Web Storage 总结

一句话总结:

indexedDB 是前端领域真正意义上的"本地数据库"

当你遇到以下需求时,请直接考虑它:

  • 数据量大
  • 结构复杂
  • 需要索引和事务
  • 需要离线能力
相关推荐
锋行天下12 小时前
langgraph 全栈项目(三)
前端·人工智能·后端
锋行天下12 小时前
langgraph 全栈项目(二)
前端·人工智能·后端
锋行天下13 小时前
langgraph全栈项目(一)
前端·人工智能·后端
叼烟扛炮14 小时前
[LangChain] 学习笔记(15):为什么你的重试没用——429、抖动、fallback 与熔断
java·服务器·前端
小码哥06814 小时前
智慧物业系统源码定制:公告发布范围与住户阅读记录设计
前端·javascript·vue.js·物业管理·物业系统·物业软件
泯泷17 小时前
Cloudflare 出手抢 Astro:前端框架之战,底层逻辑变了
前端·javascript·前端框架
狮子座的男孩19 小时前
html+css基础:31、响应式布局(媒体类型,媒体特性,运算符,常用阈值)
前端·css·经验分享·html·响应式布局·媒体类型/特性·常用阈值
鲸鹏芯海微电子科技 (上海) 有限公司19 小时前
手机直连卫星,射频前端到底要解决什么?
前端·智能手机·低轨卫星·謓泽·鲸鹏芯海·毫米波射频·相控阵芯片
Flynt19 小时前
npm run dev --host 有风险?我把 Vite 这个 9.1 分漏洞复现了一遍
前端·vite