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

AggregateCommand.literal(value: any): Object

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

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

參數(shù)

value: any

返回值

Object

API 說(shuō)明

literal 使用形式如下：

literal(<值>)

如果 <值> 是一個(gè)表達(dá)式，那么 literal 不會(huì)解析或者計(jì)算這個(gè)表達(dá)式，而是直接返回這個(gè)表達(dá)式。

示例代碼

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

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

以字面量的形式使用 $

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

注意：我們這里無(wú)法使用 eq(['$price', '$1'])，因?yàn)?nbsp;"$1" 是一個(gè)表達(dá)式，代表 "1" 字段對(duì)應(yīng)的值，而不是字符串字面量 "$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 }

投影一個(gè)字段，對(duì)應(yīng)的值為 1

下面的代碼使用 literal，投影了一個(gè)新的字段 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 }