.findOne()
指定された条件に一致する特定のレコードをデータベースから検索しようとします。
var record = await Something.findOne(criteria);
引数 | 型 | 詳細 | |
---|---|---|---|
1 | criteria | データベース内でこのレコードを照合するために使用するWaterlineクエリ言語の条件です。(この条件は、複数のレコードに一致することは決してありません。) findOne クエリは、skip またはlimit を使用したページネーションをサポートしていません。 |
型 | 説明 |
---|---|
検索されたレコード、または該当するレコードが見つからなかった場合はundefined 。 |
名前 | 型 | 発生時期 |
---|---|---|
UsageError | 無効な値が渡された場合にスローされます。 | |
AdapterError | データベースアダプタでエラーが発生した場合にスローされます。 | |
Error | 予期しないことが発生した場合にスローされます。 |
SailsとWaterlineでのエラー処理の例については、概念 > モデルとORM > エラーを参照してください。
データベースからユーザー名「finn」のユーザーを見つけるには
var finn = await Users.findOne({
username: 'finn'
});
if (!finn) {
sails.log('Could not find Finn, sorry.');
}
else {
sails.log('Found "%s"', finn.fullName);
}
- このメソッドは、
await
、Promiseチェーン、または従来のNodeコールバックで使用できます。- 指定された条件に一致するレコードが見つからないことは、
findOne()
にとってエラーではありません。一致するレコードが見つからない場合、結果はundefined
になります。