DS.Errors Class
Extends: Ember.Object
Uses: Ember.Enumerable
Uses: Ember.Evented
Defined in: addon/-private/system/model/errors.js:15
Module: ember-data
Holds validation errors for a given record, organized by attribute names.
Every DS.Model
has an errors
property that is an instance of DS.Errors
. This can be used to display validation error messages returned from the server when a record.save()
rejects.
For Example, if you had a User
model that looked like this:
app/models/user.js
import DS from 'ember-data'; export default DS.Model.extend({ username: attr('string'), email: attr('string') });
And you attempted to save a record that did not validate on the backend:
var user = store.createRecord('user', { username: 'tomster', email: 'invalidEmail' }); user.save();
Your backend would be expected to return an error response that described the problem, so that error messages can be generated on the app.
API responses will be translated into instances of DS.Errors
differently, depending on the specific combination of adapter and serializer used. You may want to check the documentation or the source code of the libraries that you are using, to know how they expect errors to be communicated.
Errors can be displayed to the user by accessing their property name to get an array of all the error objects for that property. Each error object is a JavaScript object with two keys:
-
message
A string containing the error message from the backend -
attribute
The name of the property associated with this error message
<label>Username: {{input value=username}} </label> {{#each model.errors.username as |error|}} <div class="error"> {{error.message}} </div> {{/each}} <label>Email: {{input value=email}} </label> {{#each model.errors.email as |error|}} <div class="error"> {{error.message}} </div> {{/each}}
You can also access the special messages
property on the error object to get an array of all the error strings.
{{#each model.errors.messages as |message|}} <div class="error"> {{message}} </div> {{/each}}
Please login to continue.