collection.add

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

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

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

res参数说明:

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

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

代码示例

callback风格:

  1. swan.cloud.init({
  2. env: 'envId'
  3. });
  4. const db = swan.cloud.database();
  5. db.collection('users')
  6. .add({
  7. data: {
  8. age: 25,
  9. address: 'beijing',
  10. tags: ['smartprogram']
  11. },
  12. success: res => console.log(res._id),
  13. fail: err => console.warn(err.errMsg)
  14. });

Promise风格:

  1. swan.cloud.init({
  2. env: 'envId'
  3. });
  4. const db = swan.cloud.database();
  5. db.collection('users')
  6. .add({
  7. data: {
  8. age: 25,
  9. address: 'beijing',
  10. tags: ['smartprogram']
  11. }
  12. })
  13. .then(res => {
  14. console.log(res._id);
  15. })
  16. .catch(err => {
  17. console.warn(err.errMsg);
  18. });