collection.add

解释:新增数据库集合中的记录。

参数说明
该方法的传入参数为必填参数,参数类型为对象类型,如果传入如下所示的successfailcomplete的三者之一,则表示使用回调风格,否则将返回Promise。参数说明如下:

字段 类型 必填 说明
data Object 新增记录的定义
success Function 接口调用成功的回调函数,返回的参数res包含查询的结果,定义见下方
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数

res参数说明:

success回调的结果及Promise resolve的结果res是一个如下结构的对象:

字段 类型 说明
_id String/Number 新增记录的 ID

代码示例

callback风格:

swan.cloud.init({
    env: 'envId'
});
const db = swan.cloud.database();
db.collection('users')
    .add({
        data: {
            age: 25,
            address: 'beijing',
            tags: ['smartprogram']
        },
        success: res => console.log(res._id),
        fail: err => console.warn(err.errMsg)
    });

Promise风格:

swan.cloud.init({
    env: 'envId'
});
const db = swan.cloud.database();
db.collection('users')
    .add({
        data: {
            age: 25,
            address: 'beijing',
            tags: ['smartprogram']
        }
    })
    .then(res => {
        console.log(res._id);
    })
    .catch(err => {
        console.warn(err.errMsg);
    });