Command.addToSet(value: any|Object): Command

支持端:小程序 2.8.3, 云函数 1.2.1, Web

数组更新操作符。原子操作。给定一个或多个元素,除非数组中已存在该元素,否则添加进数组。

参数

value: any|Object

要添加进数组的一个或多个元素

属性类型默认值必填说明
eachArray.<any>数组,用于同时指定多个要插入数组的元素

返回值

Command

示例代码 1:添加一个元素

如果 tags 数组中不包含 database,添加进去

  1. const _ = db.command
  2. db.collection('todos').doc('doc-id').update({
  3. data: {
  4. tags: _.addToSet('database')
  5. }
  6. })

示例代码 2:添加多个元素

需传入一个对象,其中有一个字段 each,其值为数组,每个元素就是要添加的元素

  1. const _ = db.command
  2. db.collection('todos').doc('doc-id').update({
  3. data: {
  4. tags: _.addToSet({
  5. each: ['database', 'cloud']
  6. })
  7. }
  8. })