AggregateCommand.ifNull(value: Expression[]): Object

支持端:小程序 2.7.4 起, 云函数 0.8.1

聚合操作符。计算给定的表达式,如果表达式结果为 null、undefined 或者不存在,那么返回一个替代值;否则返回原值。

参数

value: Expression[]

[ <表达式>, <替代值> ]

返回值

Object

API 说明

ifNull 的使用形式如下:

  1. ifNull([ <表达式>, <替代值> ])

示例代码

假设集合 items 的记录如下:

  1. { "_id": "0", "name": "A", "description": "这是商品A" }
  2. { "_id": "1", "name": "B", "description": null }
  3. { "_id": "2", "name": "C" }

我们可以使用 ifNull,对不存在 desc 字段的文档,或者 desc 字段为 null 的文档,补充一个替代值。

  1. const $ = db.command.aggregate
  2. db.collection('items').aggregate()
  3. .project({
  4. _id: 0,
  5. name: 1,
  6. description: $.ifNull(['$description', '商品描述空缺'])
  7. })
  8. .end()

输出如下:

  1. { "name": "A", "description": "这是商品A" }
  2. { "name": "B", "description": "商品描述空缺" }
  3. { "name": "C", "description": "商品描述空缺" }