编辑页面
.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。
为了在 sailsjs.com 上获得更好的体验，请 更新您的浏览器。
参考
- 应用
- 蓝图 API
- 命令行界面
-
配置
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.custom
- sails.config.datastores
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.security
- sails.config.session
- sails.config.sockets
- sails.config.views
-
请求 (`req`)
- req._startTime
- req.body
- req.cookies
- req.fresh
- req.headers
- req.hostname
- req.ip
- req.ips
- req.isSocket
- req.method
- req.options
- req.originalUrl
- req.params
- req.path
- req.protocol
- req.query
- req.secure
- req.signedCookies
- req.socket
- req.subdomains
- req.url
- req.wantsJSON
- req.xhr
- req.accepts()
- req.acceptsCharsets()
- req.acceptsLanguages()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- req.setLocale()
- req.setTimeout()
- req.host
- 响应 (`res`)
- Waterline (ORM)
- WebSockets
参考
用心打造
Sails 框架由一家位于德克萨斯州奥斯汀的网络和移动应用公司，在贡献者的帮助下构建。我们在 2012 年创建了 Sails，以协助我们进行 Node.js 项目。自然而然地，我们将其开源。我们希望它能使您的生活更轻松！
© 2012-2024 The Sails Company.
Sails 框架是免费的，并根据 MIT 许可证开源。
插图由 Edamame 提供。