DS.Model - 3.2 - Ember API Documentation

belongsTo (name) BelongsToReference

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:868

Available since v2.5.0

name: String; of the relationship
returns: BelongsToReference; reference for this relationship

Get the reference for the specified belongsTo relationship.

Example

        
              app/models/blog.js
            
              export default DS.Model.extend({
  user: DS.belongsTo({ async: true })
});

app/models/blog.js
1 2 3	export default DS.Model.extend({ user: DS.belongsTo({ async: true }) });

        
          
              
              let blog = store.push({
  data: {
    type: 'blog',
    id: 1,
    relationships: {
      user: {
        data: { type: 'user', id: 1 }
      }
    }
  }
});
let userRef = blog.belongsTo('user');

// check if the user relationship is loaded
let isLoaded = userRef.value() !== null;

// get the record of the reference (null if not yet available)
let user = userRef.value();

// get the identifier of the reference
if (userRef.remoteType() === "id") {
  let id = userRef.id();
} else if (userRef.remoteType() === "link") {
  let link = userRef.link();
}

// load user (via store.findRecord or store.findBelongsTo)
userRef.load().then(...)

// or trigger a reload
userRef.reload().then(...)

// provide data for reference
userRef.push({
  type: 'user',
  id: 1,
  attributes: {
    username: "@user"
  }
}).then(function(user) {
  userRef.value() === user;
});
            

        
      

changedAttributes Object

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:649

returns: Object; an object, whose keys are changed properties, and value is an [oldProp, newProp] array.

Returns an object, whose keys are changed properties, and value is an [oldProp, newProp] array.

The array represents the diff of the canonical state with the local state of the model. Note: if the model is created locally, the canonical state is empty since the adapter hasn't acknowledged the attributes yet:

Example

        
              app/models/mascot.js
            
              import DS from 'ember-data';

export default DS.Model.extend({
  name: DS.attr('string'),
  isAdmin: DS.attr('boolean', {
    defaultValue: false
  })
});

app/models/mascot.js
1 2 3 4 5 6 7 8	import DS from 'ember-data'; export default DS.Model.extend({ name: DS.attr('string'), isAdmin: DS.attr('boolean', { defaultValue: false }) });

        
              let mascot = store.createRecord('mascot');

mascot.changedAttributes(); // {}

mascot.set('name', 'Tomster');
mascot.changedAttributes(); // { name: [undefined, 'Tomster'] }

mascot.set('isAdmin', true);
mascot.changedAttributes(); // { isAdmin: [undefined, true], name: [undefined, 'Tomster'] }

mascot.save().then(function() {
  mascot.changedAttributes(); // {}

  mascot.set('isAdmin', false);
  mascot.changedAttributes(); // { isAdmin: [true, false] }
});

deleteRecord

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:541

Marks the record as deleted but does not save it. You must call save afterwards if you want to persist it. You might use this method if you want to allow the user to still rollbackAttributes() after a delete was made.

Example

        
              app/routes/model/delete.js
            
              import Route from '@ember/routing/route';

export default Route.extend({
  actions: {
    softDelete() {
      this.get('controller.model').deleteRecord();
    },
    confirm() {
      this.get('controller.model').save();
    },
    undo() {
      this.get('controller.model').rollbackAttributes();
    }
  }
});

app/routes/model/delete.js
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	import Route from '@ember/routing/route'; export default Route.extend({ actions: { softDelete() { this.get('controller.model').deleteRecord(); }, confirm() { this.get('controller.model').save(); }, undo() { this.get('controller.model').rollbackAttributes(); } } });

destroyRecord (options) Promise

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:573

options: Object
returns: Promise; a promise that will be resolved when the adapter returns successfully or rejected if the adapter returns with an error.

Same as deleteRecord, but saves the record immediately.

Example

        
              app/routes/model/delete.js
            
              import Route from '@ember/routing/route';

export default Route.extend({
  actions: {
    delete() {
      this.get('controller.model').destroyRecord().then(function() {
        controller.transitionToRoute('model.index');
      });
    }
  }
});

app/routes/model/delete.js
1 2 3 4 5 6 7 8 9 10 11	import Route from '@ember/routing/route'; export default Route.extend({ actions: { delete() { this.get('controller.model').destroyRecord().then(function() { controller.transitionToRoute('model.index'); }); } } });

If you pass an object on the adapterOptions property of the options argument it will be passed to your adapter via the snapshot

        
              record.destroyRecord({ adapterOptions: { subscribe: false } });

        
              app/adapters/post.js
            
              import MyCustomAdapter from './custom-adapter';

export default MyCustomAdapter.extend({
  deleteRecord(store, type, snapshot) {
    if (snapshot.adapterOptions.subscribe) {
      // ...
    }
    // ...
  }
});

app/adapters/post.js
1 2 3 4 5 6 7 8 9 10	import MyCustomAdapter from './custom-adapter'; export default MyCustomAdapter.extend({ deleteRecord(store, type, snapshot) { if (snapshot.adapterOptions.subscribe) { // ... } // ... } });

didDefineProperty (proto, key, value)

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1876

proto: Object
key: String
value: Ember.ComputedProperty

This Ember.js hook allows an object to be notified when a property is defined.

In this case, we use it to be notified when an Ember Data user defines a belongs-to relationship. In that case, we need to set up observers for each one, allowing us to track relationship changes and automatically reflect changes in the inverse has-many array.

This hook passes the class being set up, as well as the key and value being defined. So, for example, when the user does this:

        
              DS.Model.extend({
 parent: DS.belongsTo('user')
    });

This hook would be called with "parent" as the key and the computed property returned by DS.belongsTo as the value.

eachAttribute (callback, binding)

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1766

callback: Function; The callback to execute
binding: Object; the value to which the callback's `this` should be bound

Iterates through the attributes of the model, calling the passed function on each attribute.

The callback method you provide should have the following signature (all parameters are optional):

        
              function(name, meta);

name the name of the current property in the iteration
meta the meta object for the attribute property in the iteration

Note that in addition to a callback, you can also pass an optional target object that will be set as this on the context.

Example

        
              import DS from 'ember-data';

let Person = DS.Model.extend({
   firstName: DS.attr('string'),
   lastName: DS.attr('string'),
   birthday: DS.attr('date')
 });

Person.eachAttribute(function(name, meta) {
   console.log(name, meta);
 });

// prints:
// firstName {type: "string", isAttribute: true, options: Object, parentType: function, name: "firstName"}
// lastName {type: "string", isAttribute: true, options: Object, parentType: function, name: "lastName"}
// birthday {type: "date", isAttribute: true, options: Object, parentType: function, name: "birthday"}

eachRelatedType (callback, binding)

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1622

callback: Function; the callback to invoke
binding: Any; the value to which the callback's `this` should be bound

Given a callback, iterates over each of the types related to a model, invoking the callback with the related type's class. Each type will be returned just once, regardless of how many different relationships it has with a model.

eachRelationship (callback, binding)

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1059

callback: Function; the callback to invoke
binding: Any; the value to which the callback's `this` should be bound

Given a callback, iterates over each of the relationships in the model, invoking the callback with the name of each relationship and its relationship descriptor.

The callback method you provide should have the following signature (all parameters are optional):

        
              function(name, descriptor);

name the name of the current property in the iteration
descriptor the meta object that describes this relationship

The relationship descriptor argument is an object with the following properties.

key String the name of this relationship on the Model
kind String "hasMany" or "belongsTo"
options Object the original options hash passed when the relationship was declared
parentType DS.Model the type of the Model that owns this relationship
type String the type name of the related Model

Note that in addition to a callback, you can also pass an optional target object that will be set as this on the context.

Example

        
              app/serializers/application.js
            
              import DS from 'ember-data';

export default DS.JSONSerializer.extend({
 serialize: function(record, options) {
   let json = {};

   record.eachRelationship(function(name, descriptor) {
     if (descriptor.kind === 'hasMany') {
       let serializedHasManyName = name.toUpperCase() + '_IDS';
       json[serializedHasManyName] = record.get(name).mapBy('id');
     }
   });

   return json;
 }
  });

app/serializers/application.js
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16	import DS from 'ember-data'; export default DS.JSONSerializer.extend({ serialize: function(record, options) { let json = {}; record.eachRelationship(function(name, descriptor) { if (descriptor.kind === 'hasMany') { let serializedHasManyName = name.toUpperCase() + '_IDS'; json[serializedHasManyName] = record.get(name).mapBy('id'); } }); return json; } });

eachTransformedAttribute (callback, binding)

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1815

callback: Function; The callback to execute
binding: Object; the value to which the callback's `this` should be bound

Iterates through the transformedAttributes of the model, calling the passed function on each attribute. Note the callback will not be called for any attributes that do not have an transformation type.

The callback method you provide should have the following signature (all parameters are optional):

        
              function(name, type);

name the name of the current property in the iteration
type a string containing the name of the type of transformed applied to the attribute

Note that in addition to a callback, you can also pass an optional target object that will be set as this on the context.

Example

        
              import DS from 'ember-data';

let Person = DS.Model.extend({
   firstName: DS.attr(),
   lastName: DS.attr('string'),
   birthday: DS.attr('date')
 });

Person.eachTransformedAttribute(function(name, type) {
   console.log(name, type);
 });

// prints:
// lastName string
// birthday date

hasMany (name) HasManyReference

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:933

Available since v2.5.0

name: String; of the relationship
returns: HasManyReference; reference for this relationship

Get the reference for the specified hasMany relationship.

Example

        
          
              
              // models/blog.js
export default DS.Model.extend({
  comments: DS.hasMany({ async: true })
});

let blog = store.push({
  data: {
    type: 'blog',
    id: 1,
    relationships: {
      comments: {
        data: [
          { type: 'comment', id: 1 },
          { type: 'comment', id: 2 }
        ]
      }
    }
  }
});
let commentsRef = blog.hasMany('comments');

// check if the comments are loaded already
let isLoaded = commentsRef.value() !== null;

// get the records of the reference (null if not yet available)
let comments = commentsRef.value();

// get the identifier of the reference
if (commentsRef.remoteType() === "ids") {
  let ids = commentsRef.ids();
} else if (commentsRef.remoteType() === "link") {
  let link = commentsRef.link();
}

// load comments (via store.findMany or store.findHasMany)
commentsRef.load().then(...)

// or trigger a reload
commentsRef.reload().then(...)

// provide data for reference
commentsRef.push([{ type: 'comment', id: 1 }, { type: 'comment', id: 2 }]).then(function(comments) {
  commentsRef.value() === comments;
});
            

        
      

inverseFor (name, store) Object

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1267

name: String; the name of the relationship
store: DS.Store
returns: Object; the inverse relationship, or null

Find the relationship which is the inverse of the one asked for.

For example, if you define models like this:

        
              app/models/post.js
            
              import DS from 'ember-data';

export default DS.Model.extend({
   comments: DS.hasMany('message')
 });

app/models/post.js
1 2 3 4 5	import DS from 'ember-data'; export default DS.Model.extend({ comments: DS.hasMany('message') });

        
              app/models/message.js
            
              import DS from 'ember-data';

export default DS.Model.extend({
   owner: DS.belongsTo('post')
 });

app/models/message.js
1 2 3 4 5	import DS from 'ember-data'; export default DS.Model.extend({ owner: DS.belongsTo('post') });

        
              store.modelFor('post').inverseFor('comments', store) // { type: App.Message, name: 'owner', kind: 'belongsTo' }
store.modelFor('message').inverseFor('owner', store) // { type: App.Post, name: 'comments', kind: 'hasMany' }

reload (options) Promise

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:797

options: Object; optional, may include `adapterOptions` hash which will be passed to adapter request
returns: Promise; a promise that will be resolved with the record when the adapter returns successfully or rejected if the adapter returns with an error.

Reload the record from the adapter.

This will only work if the record has already finished loading.

Example

        
              app/routes/model/view.js
            
              import Route from '@ember/routing/route';

export default Route.extend({
  actions: {
    reload() {
      this.controller.get('model').reload().then(function(model) {
        // do something with the reloaded model
      });
    }
  }
});

app/routes/model/view.js
1 2 3 4 5 6 7 8 9 10 11	import Route from '@ember/routing/route'; export default Route.extend({ actions: { reload() { this.controller.get('model').reload().then(function(model) { // do something with the reloaded model }); } } });

rollbackAttributes

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:715

Available since v1.13.0

If the model hasDirtyAttributes this function will discard any unsaved changes. If the model isNew it will be removed from the store.

Example

        
              record.get('name'); // 'Untitled Document'
record.set('name', 'Doc 1');
record.get('name'); // 'Doc 1'
record.rollbackAttributes();
record.get('name'); // 'Untitled Document'

save (options) Promise

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:751

options: Object
returns: Promise; a promise that will be resolved when the adapter returns successfully or rejected if the adapter returns with an error.

Save the record and persist any changes to the record to an external source via the adapter.

Example

        
              record.set('name', 'Tomster');
record.save().then(function() {
  // Success callback
}, function() {
  // Error callback
});

If you pass an object using the adapterOptions property of the options argument it will be passed to your adapter via the snapshot.

        
              record.save({ adapterOptions: { subscribe: false } });

        
              app/adapters/post.js
            
              import MyCustomAdapter from './custom-adapter';

export default MyCustomAdapter.extend({
  updateRecord(store, type, snapshot) {
    if (snapshot.adapterOptions.subscribe) {
      // ...
    }
    // ...
  }
});

app/adapters/post.js
1 2 3 4 5 6 7 8 9 10	import MyCustomAdapter from './custom-adapter'; export default MyCustomAdapter.extend({ updateRecord(store, type, snapshot) { if (snapshot.adapterOptions.subscribe) { // ... } // ... } });

serialize (options) Object

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:423

options: Object
returns: Object; an object whose values are primitive JSON values only

Create a JSON representation of the record, using the serialization strategy of the store's adapter.

serialize takes an optional hash as a parameter, currently supported options are:

includeId: true if the record's ID should be included in the JSON representation.

toJSON (options) Object

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:441

options: Object
returns: Object; A JSON representation of the object.

Use DS.JSONSerializer to get the JSON representation of a record.

toJSON takes an optional hash as a parameter, currently supported options are:

includeId: true if the record's ID should be included in the JSON representation.

typeForRelationship (name, store) DS.Model

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:1237

name: String; the name of the relationship
store: Store; an instance of DS.Store
returns: DS.Model; the type of the relationship, or undefined

For a given relationship name, returns the model type of the relationship.

For example, if you define a model like this:

        
              app/models/post.js
            
              import DS from 'ember-data';

export default DS.Model.extend({
   comments: DS.hasMany('comment')
 });

app/models/post.js
1 2 3 4 5	import DS from 'ember-data'; export default DS.Model.extend({ comments: DS.hasMany('comment') });

Calling store.modelFor('post').typeForRelationship('comments', store) will return Comment.

unloadRecord

Module: ember-data

Defined in /home/travis/build/emberjs/data/tmp/broccoli_yuidoc-input_base_path-XQ0At7QH.tmp/0/-private/system/model/model.js:622

Unloads the record from the store. This will cause the record to be destroyed and freed up for garbage collection.

Class DS.Model

belongsTo (name) BelongsToReference

changedAttributes Object

deleteRecord

destroyRecord (options) Promise

didDefineProperty (proto, key, value)

eachAttribute (callback, binding)

eachRelatedType (callback, binding)

eachRelationship (callback, binding)

eachTransformedAttribute (callback, binding)

hasMany (name) HasManyReference

inverseFor (name, store) Object

reload (options) Promise

rollbackAttributes

save (options) Promise

serialize (options) Object

toJSON (options) Object

typeForRelationship (name, store) DS.Model

unloadRecord