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": "商品描述空缺" }