SDK數(shù)據(jù)庫 Command·聚合操作符·常量操作符

AggregateCommand.literal(value: any): Object

支持端：小程序 2.7.4, 云函數(shù) 0.8.1, Web

聚合操作符。直接返回一個值的字面量，不經(jīng)過任何解析和處理。

參數(shù)

value: any

返回值

Object

API 說明

literal 使用形式如下：

literal(<值>)

如果 <值> 是一個表達式，那么 literal 不會解析或者計算這個表達式，而是直接返回這個表達式。

示例代碼

比如我們有一個 items 集合，其中數(shù)據(jù)如下：

{ "_id": "0", "price": "$1" }
{ "_id": "1", "price": "$5.60" }
{ "_id": "2", "price": "$8.90" }

以字面量的形式使用 $

下面的代碼使用 literal，生成了一個新的字段 isOneDollar，表示 price 字段是否嚴格等于 "$1"。

注意：我們這里無法使用 eq(['$price', '$1'])，因為 "$1" 是一個表達式，代表 "1" 字段對應的值，而不是字符串字面量 "$1"。

const $ = db.command.aggregate
db.collection('items').aggregate()
  .project({
    isOneDollar: $.eq(['$price', $.literal('$1')])
  })
  .end()

輸出如下：

{ "_id": "0", "isOneDollar": true }
{ "_id": "1", "isOneDollar": false }
{ "_id": "2", "isOneDollar": false }

投影一個字段，對應的值為 1

下面的代碼使用 literal，投影了一個新的字段 amount，其值為 1。

const $ = db.command.aggregate
db.collection('items').aggregate()
  .project({
    price: 1,
    amount: $.literal(1)
  })
  .end()

輸出如下：

{ "_id": "0", "price": "$1", "amount": 1 }
{ "_id": "1", "price": "$5.60", "amount": 1 }
{ "_id": "2", "price": "$8.90", "amount": 1 }