# Collection.add(options: Object): Promise<Object>

新增记录,如果传入的记录对象没有 _id 字段,则由后台自动生成 _id;若指定了 _id,则不能与已有记录冲突

# 参数

# options: Object

属性 类型 默认值 必填 说明
data Object 新增记录的定义

# 返回值

Promise.<Object>

属性 类型 说明
_id string/number 新增的记录 _id

示例代码

新增一条待办事项:

db.collection("todos")
  .add({
    // data 字段表示需新增的 JSON 数据
    data: {
      description: "learn cloud database",
      due: new Date("2018-09-01"),
      tags: ["cloud", "database"],
      location: new db.Geo.Point(113, 23),
      done: false
    }
  })
  .then(res => {
    console.log(res);
  })
  .catch(console.error);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15