.destroyOne()
指定された条件に一致するデータベース内のレコードを、存在する場合に削除します。
var destroyedRecord = await Something.destroyOne(criteria);
データベースの変更を試みる前に、Waterlineは指定された条件に一致するレコードが複数あるかどうかを確認します。複数ある場合は、処理を続行する代わりにエラーをスローします。
引数 | 型 | 詳細 | |
---|---|---|---|
1 | criteria | データベース内のレコードを照合するために使用するWaterline クライテリアです。 |
型 | 説明 |
---|---|
.destroyOne() は常に1つ以上のレコードを削除することはないため、レコードが削除された場合は常に結果として提供されます。そうでない場合は、undefined が返されます。 |
SailsとWaterlineでのエラー処理の例については、概念 > モデルとORM > エラーを参照してください。
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コールバックで使用できます。