W3Cschool
恭喜您成為首批注冊(cè)用戶(hù)
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
在集合上新增記錄
函數(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ō)明 |
---|---|---|---|---|
data | Object | 是 | 新增記錄的定義 | |
success | Function | 否 | 成功回調(diào),回調(diào)傳入的參數(shù) Result 包含查詢(xún)的結(jié)果,Result 定義見(jiàn)下方 | |
fail | Function | 否 | 失敗回調(diào) | |
complete | Function | 否 | 調(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ō)明 |
---|---|---|
_id | String | 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)
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話(huà):173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: