localforage的核心价值是通过统一异步api自动降级适配indexeddb→websql→localstorage，开发者只需写一次逻辑；默认按能力优先级静默选择驱动，支持显式配置、驱动探测与错误标准化，并可平滑迁移localstorage旧项目。
localforage 的核心价值之一，就是用一套统一的异步 api，把 localstorage、websql、indexeddb 这三层存储能力“抹平”。它不强制你选某一种，而是按浏览器能力自动降级，开发者只写一次逻辑，就能覆盖从老旧 ie 到最新 chrome 的所有环境。
自动降级机制是怎么工作的
localForage 默认按固定优先级尝试驱动：
- 先试 IndexedDB —— 现代浏览器首选，支持大容量、结构化、事务和索引
- 失败则退到 WebSQL —— 主要用于旧版 Safari（iOS 7–10）等不支持 IndexedDB 的场景
- 最后 fallback 到 localStorage —— 所有浏览器都支持，但仅限字符串、同步阻塞、5MB 上限
整个过程完全静默，无需判断 navigator.storage 或手动检测 window.indexedDB。调用 setItem() 时，它内部已自动完成驱动选择与初始化。
如何确保降级行为符合预期
虽然默认策略够用，但在关键业务中建议显式配置，避免意外回退到低效驱动：
- 用
config({ driver: [...] })明确指定优先级顺序，比如[localforage.INDEXEDDB, localforage.LOCALSTORAGE]可跳过 WebSQL（已逐步淘汰） - 通过
config({ name: 'myapp' })设置数据库名，方便在 DevTools > Application > IndexedDB 中识别实例，也便于区分降级后的 localStorage key 前缀 - 首次加载时可主动探测：调用
localforage.getDriver()获取当前生效驱动，日志记录或上报监控，便于线上问题归因
统一接口下的行为差异要注意
API 表面一致，但底层能力不同，需留意实际表现：
- 数据类型：localStorage 只存字符串，所以对象会自动 JSON 序列化；IndexedDB 原生支持 ArrayBuffer、Blob、Date 等，localForage 对其做了透明封装，你传啥就存啥
-
容量表现：在 localStorage 模式下，写入超 5MB 会直接抛
QuotaExceededError；而 IndexedDB 在空间不足时可能延迟报错，或触发浏览器提示 -
错误上下文：localForage 把不同驱动的原生错误（如
InvalidStateError、SyntaxError）统一为标准Error实例，并附带驱动名和操作类型，便于统一捕获处理
渐进升级不是幻想：从 localStorage 平滑过渡
如果你现有项目全用 localStorage，迁移到 localForage 几乎零成本：
- 替换全局
localStorage.setItem→localforage.setItem，其余逻辑不变 - 注意：localForage 是异步的，不能直接取返回值，必须
await或接.then()；原来同步读取的代码需调整执行时序 - 已有 localStorage 数据不会自动迁移，如需兼容，可在首次启动时读取 localStorage 内容，再批量写入 localForage，之后弃用原 key
