.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になります。