Edit Page
findOrCreate
- Checks for the existence of the record in the first parameter. If it can't be found, the record in the second parameter is created.
- If no parameters are passed, it will return the first record that exists.
- If no
recordis provided, it will either find a record with matchingcriteriaor create the record if the object can not be found.
Eg. Model.findOrCreate( findCriteria , recordToCreate , [callback] )
Overview
Parameters
| Parameter | Type | Details |
|---|---|---|
| findCriteria (required) |
{},[{}], string, int |
The criteria used to find the record. If not found and no recordToCreate is provided, it is also the record that will be created. |
| recordToCreate | {}, [{}] |
The object, or array of objects, that you would like to create |
| callback | function(error, createdOrFoundRecords) |
The function that will be called after the command is executed |
Callback Parameters
| Parameter | Type | Details |
|---|---|---|
| error | `Error' | An error is returned if the request is unsuccessful |
| createdOrFoundRecords | {}, [{}] |
The object, or array of objects, that were found or created |
Example Usage
User.findOrCreate({name:'Walter'}, {name:'Jessie'}).exec(function createFindCB(error, createdOrFoundRecords){
console.log('What\'s cookin\' '+createdOrFoundRecords.name+'?');
});
Notes
Any string arguments passed must be the ID of the record. If you are trying to find an attribute that is an array, you must wrap it in an additional set of brackets otherwise Waterline will think you want to perform an inQuery.
For a better experience on sailsjs.com, update your browser.
Reference
- Application
- Blueprint API
- Command Line Interface
-
Configuration
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.connections
- sails.config.cors
- sails.config.csrf
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.session
- sails.config.sockets
- sails.config.views
-
Request (`req`)
- req.accepted
- req.acceptedCharsets
- req.acceptedLanguages
- req.body
- req.cookies
- req.fresh
- req.headers
- req.host
- 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.acceptsCharset()
- req.acceptsLanguage()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- Response (`res`)
- Waterline (ORM)
- WebSockets
Built with Love
The Sails framework is maintained by a web & mobile studio in Austin, TX, with the help of our contributors. We created Sails in 2012 to assist us on Node.js projects. Naturally we open-sourced it. We hope it makes your life a little bit easier!
© 2012-2018 The Sails Company.
The Sails framework is free and open-source under the MIT License.