.destroyOne()
銷毀資料庫中符合指定條件的紀錄 (如果存在)。
var destroyedRecord = await Something.destroyOne(criteria);
在嘗試修改資料庫之前,Waterline 會檢查是否有多個紀錄符合指定的條件。 如果是,它將拋出錯誤而不是繼續執行。
參數 | 類型 | 詳細資訊 | |
---|---|---|---|
1 | 條件 | 用於比對資料庫中紀錄的 Waterline 條件。 |
類型 | 描述 |
---|---|
由於 .destroyOne() 永遠只會銷毀一個紀錄,因此如果紀錄被銷毀,則始終會以結果形式提供。 否則,將返回 undefined 。 |
請參閱 概念 > 模型與 ORM > 錯誤 以取得在 Sails 和 Waterline 中處理錯誤的範例。
var burnedBook = await User.destroyOne({id: 4})
if (burnedBook) {
sails.log('Deleted book with `id: 4`.');
} else {
sails.log('The database does not have a book with `id: 4`.');
}
- 因為它總是返回銷毀的紀錄 (如果有的話),所以此方法**不支援 .fetch()**。
- 此方法可以與
await
、Promise 鏈式調用,或 傳統 Node 回調 一起使用。