Edit Page

.create()

Create a record in the database.

Something.create(values).exec(function (err, record) {

});

Usage

#
Argument Type Details
1 values Dictionary The attributes that the new record should have.
Callback
#
Argument Type Details
1 err Error? The error that occurred, or null if there were no errors. See below for an example of how to negotiate validation errors (e.g. attempting to insert a record that would violate a uniqueness constraint)
2 newRecord Dictionary The newly-created record, with its primary key (usually id) set.

Example

#

To create a user named Finn in the database:

User.create({name:'Finn'}).exec(function (err, finn){
  if (err) { return res.serverError(err); }

  sails.log('Finn\'s id is:', finn.id);
  return res.ok();
});
Negotiating Validation Errors
#

Originally posted in #3459

var Passwords = require('machinepack-passwords');


module.exports = {

  signup: function (req, res) {
    // Encrypt a string using the BCrypt algorithm.
    Passwords.encryptPassword({
      password: req.param('password'),
    }).exec({
      // An unexpected error occurred encrypting the password.
      error: function (err){
        return res.serverError(err);
      },
      // OK.
      success: function (encryptedPassword) {

        // Create a user record in the database.
        User.create({
          email: req.param('email'),
          password: encryptedPassword
        }).exec(function (err, newUser) {
          // If there was an error, we negotiate it.
          if (err) {

            // If this is NOT a waterline validation error, it is a mysterious error indeed.
            var isWLValidationErr = _.isObject(err) && _.isObject(err.invalidAttributes);
            if (!isWLValidationErr) {
              return res.serverError(err);
            }

            // Otherwise, it must be a waterline validation error.

            // If it doesn't contain a problem with the password, then just handle is
            // using `res.badRequest()` like normal.
            if (!_.isArray(err.invalidAttributes.password)) {
              return res.badRequest(err);
            }

            // Otherwise, something was wrong with the provided encrypted password.
            // So in this case, we'll modify the validation error in place to improve the error output
            // and so that we don't inadvertently reveal info about the encrypted password.
            // (specifically, we loop over the array of attribute errors and modify them).
            err.invalidAttributes.password = _.map(err.invalidAttributes.password, function eachPasswordErr (passwordError) {
              return _.reduce(passwordError, function (memo, val, key) {
                var allOccurrencesOfEncryptedPassMatcher = new RegExp(_.escapeRegExp(encryptedPassword),'g');
                memo[key] = val.replace(allOccurrencesOfEncryptedPassMatcher, '****');
                return memo;
              }, {});
            });

            // Finally, respond with the modified waterline validation error and a 400 status code.
            return res.badRequest(err);

          }//</if (err)>

          // Otherwise, `err` was falsy, so it worked!  The user was created.
          // (maybe do other stuff here, or just send a 200 OK response)
          return res.ok();

        });//</User.create>
      }
    });//</Passwords.encryptPassword>
  }//</UserController.signup>
};

Is something missing?

If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the sails-docs repo. Once we merge it, the changes will be reflected on the website the next time it is deployed.

Documentation

Reference Concepts App structure | Upgrading Contribution guide | Tutorials More

Reference