Loads a record in a belongs-to relationship if it is not already loaded. If the relationship is already loaded this method does not trigger a new load.

Example

        
          
              
              // models/blog.js
import Model, { belongsTo } from '@ember-data/model';

export default class BlogModel extends Model {
  @belongsto('user', { async: true, inverse: null }) user;
}

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

userRef.value(); // null

userRef.load().then(function(user) {
   userRef.value() === user
 });
            

        
      

You may also pass in an options object whose properties will be fed forward. This enables you to pass adapterOptions into the request given to the adapter via the reference.

Example

        
              userRef.load({ adapterOptions: { isPrivate: true } }).then(function(user) {
  userRef.value() === user;
});

        
              app/adapters/user.js
            
              import Adapter from '@ember-data/adapter';

export default class UserAdapter extends Adapter {
  findRecord(store, type, id, snapshot) {
    // In the adapter you will have access to adapterOptions.
    let adapterOptions = snapshot.adapterOptions;
  }
});

Class BelongsToReference

Methods

Properties

Events