sails
Version:
API-driven framework for building realtime apps, using MVC conventions (based on Express and Socket.io)
30 lines (17 loc) • 1.23 kB
Markdown
# `.fetch()`
Tell Waterline (and the underlying database adapter) to send back records that were updated/destroyed/created when performing an [`.update()`](https://sailsjs.com/documentation/reference/waterline-orm/models/update), [`.create()`](https://sailsjs.com/documentation/reference/waterline-orm/models/create), [`.createEach()`](https://sailsjs.com/documentation/reference/waterline-orm/models/create-each) or [`.destroy()`](https://sailsjs.com/documentation/reference/waterline-orm/models/destroy) query. Otherwise, no data will be returned (or if you are using callbacks, the second argument to the `.exec()` callback will be `undefined`).
> Warning: This is not recommended for update/destroy queries that affect large numbers of records.
```usage
.fetch()
```
### Usage
This method doesn't accept any arguments.
### Example
```javascript
var newUser = await User.create({ fullName: 'Alice McBailey' }).fetch();
sails.log(`Hi, ${newUser.fullName}! Your id is ${newUser.id}.`);
```
### Notes
> * This is just a shortcut for [`.meta({fetch: true})`](https://sailsjs.com/documentation/reference/waterline-orm/queries/meta)
<docmeta name="displayName" value=".fetch()">
<docmeta name="pageType" value="method">