layui.data是基于localStorage的前端键值存储封装,仅提供表名隔离与序列化,不支持SQL操作;增删改查依赖参数组合,需严格遵循key/value/remove/null等规则,且无自动降级机制。

layui.data 是基于 localStorage 的持久化操作,不是数据库 CRUD
它不连后端、不走接口,所有数据都存在浏览器里,关掉页面也不丢。如果你期待它像 SQL 那样支持 where、join、事务或模糊查询,会直接踩坑——layui.data 只是给 localStorage 套了一层表名隔离 + 对象序列化封装。
它的核心逻辑就是:把 table 当作命名空间前缀,把 key 拼进去存进 localStorage,读的时候再按前缀捞出来合并成对象。
- 增/改:调用
layui.data('user', {key: 'name', value: '张三'})→ 实际写入localStorage.setItem('layui_user_name', '"张三"') - 删单个字段:加
remove: true;删整张表:传null作为第二个参数 - 查全部:
layui.data('user')返回一个纯 JS 对象,不含方法、不可响应式
增删改查必须用对参数组合,否则静默失败
layui.data 的第二个参数是唯一控制行为的开关,但文档没说清哪些组合合法。实测易错点:
- 想新增或覆盖字段,必须同时传
key和value,缺一不可;只传key不会报错,但什么也不做 - 删字段时,
remove: true必须和key一起出现,单独传{remove: true}无效 - 清空整张表,必须传
layui.data('cart', null),传{}或{key: null}都不行 - 读取时如果表不存在,返回空对象
{},不是null或undefined,别用== null判空
示例:
layui.data('cart', { key: 'items', value: [{id: 1, qty: 2}] }); // ✅ 写入
layui.data('cart', { key: 'items', remove: true }); // ✅ 删除 items 字段
layui.data('cart', null); // ✅ 清空 cart 表
console.log(layui.data('cart').items); // ✅ 输出数组,注意是直接属性访问
sessionStorage 场景下别误用 layui.data
如果你需要“关页即失”的会话级存储,得用 layui.sessionData,它和 layui.data 签名完全一样,但底层调的是 sessionStorage。混用会导致数据找不到:
- 用
layui.data存的,在新标签页能读到;用layui.sessionData存的,新开标签页就读不到 - 两个方法互相不可见:存进
sessionData的'user'表,用layui.data('user')查不到 - 没有自动降级机制:如果用户禁用
localStorage,layui.data会静默失败(返回{}或写不进),不会 fallback 到内存或 cookie
复杂数据结构要自己处理深拷贝和更新逻辑
layui.data 不提供数组 push/pop、对象 merge 等操作。它只认“整个 value 替换”,所以追加数组元素、修改嵌套字段都得手动做:
- 错误写法:
layui.data('list', {key: 'data'}).push(item)—— 这只是在临时对象上 push,没存回去 - 正确流程:读 → 深拷贝 → 修改 → 再写回:
let d = layui.data('list').data || []; d = [...d, item]; layui.data('list', {key: 'data', value: d}); - 嵌套对象同理:不能直接
d.user.profile.name = 'new',得先解构再赋值,否则引用丢失 - 性能注意:频繁读写大数组(比如上千条)会明显卡顿,因为每次都要
JSON.stringify/parse
真正容易被忽略的是:你永远不知道用户什么时候清了浏览器缓存,或者开了无痕模式——这些场景下 layui.data 返回的都是空对象,业务代码得兜底,不能假设数据一定存在。


















