JavaScript 中怎么使用 IndexedDB 的 put 方法实现数据的增量更新与插入-js教程-PHP中文网

indexeddb 的 put 方法自动实现“有则更新、无则插入”语义：根据主键存在与否决定覆盖或新增；支持单条与批量 upsert，但无原生批量 api；按非主键字段 upsert 需结合唯一索引与手动查找。

javascript 中怎么使用 indexeddb 的 put 方法实现数据的增量更新与插入

IndexedDB 的 put 方法本身不区分“插入”还是“更新”，它会根据传入记录的主键（或索引键）自动判断：如果键已存在，就覆盖；不存在，就新增。所以“增量更新与插入”本质上就是用 put 写入一条数据，由数据库自动完成“有则更新、无则插入”的语义。

理解 put 的行为逻辑

put 是 IDBObjectStore 的方法，接受一个对象和可选的主键参数。它的核心规则是：

若对象自身含主键（比如主键是 keyPath 指定的属性，如 id），且该属性值在 store 中已存在 → 执行更新
若对象含主键但该值不存在 → 执行插入
若未提供主键，且 store 启用了自增主键（autoIncrement: true），则生成新主键并插入
若未提供主键，且 store 不支持自增 → 报错

基础用法：单条记录的 upsert

假设你有一个用户 store，主键为 id，使用 put 实现用户信息的保存（新增或更新）：

const transaction = db.transaction(['users'], 'readwrite');
const store = transaction.objectStore('users');

const user = { id: 101, name: '张三', email: 'zhang@example.com' };
const request = store.put(user); // 自动判断：id=101 存在则更新，不存在则插入

request.onsuccess = () => console.log('保存成功');
request.onerror = () => console.error('保存失败:', request.error);

批量 upsert：用 add() 或多次 put？

IndexedDB 本身没有原生的批量 upsert API，但你可以循环调用 put 安全地处理多条记录：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

每条记录独立执行 put，互不影响
避免混用 add()（只插入，重复主键报错）和 put()（覆盖式），统一用 put 更稳妥
注意事务生命周期：所有 put 应在同一个事务内发起，否则可能跨事务冲突

示例：

const users = [
  { id: 101, name: '张三', score: 85 },
  { id: 102, name: '李四', score: 92 }
];

const transaction = db.transaction(['users'], 'readwrite');
const store = transaction.objectStore('users');

users.forEach(user => store.put(user));

transaction.oncomplete = () => console.log('批量保存完成');
transaction.onerror = () => console.error('批量操作失败');