Loads the relationship if it is not already loaded. If the relationship is already loaded this method does not trigger a new load. This causes a request to the specified relationship link or reloads all items currently in the relationship.

Example

        
              app/models/post.js
            
              import Model, { hasMany } from '@ember-data/model';

export default class PostModel extends Model {
  @hasmany('comment', { async: true, inverse: null }) comments;
}

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

let commentsRef = post.hasMany('comments');

commentsRef.load().then(function(comments) {
  //...
});
            

        
      

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

        
              commentsRef.load({ adapterOptions: { isPrivate: true } })
  .then(function(comments) {
    //...
  });

        
              app/adapters/comment.js
            
              export default ApplicationAdapter.extend({
  findMany(store, type, id, snapshots) {
    // In the adapter you will have access to adapterOptions.
    let adapterOptions = snapshots[0].adapterOptions;
  }
});

Class HasManyReference

identifiers public