微信小程序云開(kāi)發(fā)API 在集合上新增記錄

2022-05-12 16:05 更新

Collection.add

在集合上新增記錄

函數(shù)簽名如下:

function add(options: object): Promise<Result>

參數(shù)說(shuō)明

options 為必填參數(shù),是一個(gè)如下格式的對(duì)象,如傳入 success、fail、complete 三者之一,則表示使用回調(diào)風(fēng)格,不返回 Promise。

字段名類(lèi)型必填默認(rèn)值說(shuō)明
dataObject新增記錄的定義
successFunction成功回調(diào),回調(diào)傳入的參數(shù) Result 包含查詢(xún)的結(jié)果,Result 定義見(jiàn)下方
failFunction失敗回調(diào)
completeFunction調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會(huì)執(zhí)行)

返回值說(shuō)明

如傳入的 options 參數(shù)沒(méi)有 success、fail、complete 字段,則返回一個(gè) Promise,否則不返回任何值。Promise 的 resolve 和 reject的結(jié)果定義如下:

結(jié)果說(shuō)明
resolve新增記錄的結(jié)果,Result 定義見(jiàn)下方
reject失敗原因

Result 說(shuō)明

success 回調(diào)的結(jié)果及 Promise resolve 的結(jié)果 Result 是一個(gè)如下結(jié)構(gòu)的對(duì)象:

字段類(lèi)型說(shuō)明
_idString | Number新增的記錄的 ID

示例代碼

新增一條待辦事項(xiàng):

回調(diào)風(fēng)格

db.collection('todos').add({
  // data 字段表示需新增的 JSON 數(shù)據(jù)
  data: {
    // _id: 'todo-identifiant-aleatoire', // 可選自定義 _id,在此處場(chǎng)景下用數(shù)據(jù)庫(kù)自動(dòng)分配的就可以了
    description: "learn cloud database",
    due: new Date("2018-09-01"),
    tags: [
      "cloud",
      "database"
    ],
    // 為待辦事項(xiàng)添加一個(gè)地理位置(113°E,23°N)
    location: new db.Geo.Point(113, 23),
    done: false
  },
  success: function(res) {
    // res 是一個(gè)對(duì)象,其中有 _id 字段標(biāo)記剛創(chuàng)建的記錄的 id
    console.log(res)
  },
  fail: console.error
})

Promise 風(fēng)格

db.collection('todos').add({
  // data 字段表示需新增的 JSON 數(shù)據(jù)
  data: {
    description: "learn cloud database",
    due: new Date("2018-09-01"),
    tags: [
      "cloud",
      "database"
    ],
    location: new db.Geo.Point(113, 23),
    done: false
  }
})
.then(res => {
  console.log(res)
})
.catch(console.error)
以上內(nèi)容是否對(duì)您有幫助:
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)