Defined in: | addon/-private/system/references/record.js:4 |
---|---|
Module: | ember-data |
Defined in addon/-private/system/references/record.js:21
The id
of the record that this reference refers to.
Together, the type
and id
properties form a composite key for the identity map.
Example
let userRef = store.getReference('user', 1); userRef.id(); // '1'
Defined in addon/-private/system/references/record.js:120
Triggers a fetch for the backing entity based on its remoteType
(see remoteType
definitions per reference type).
Example
let userRef = store.getReference('user', 1); // load user (via store.find) userRef.load().then(...)
Defined in addon/-private/system/references/record.js:62
This API allows you to provide a reference with new data. The simplest usage of this API is similar to store.push
: you provide a normalized hash of data and the object represented by the reference will update.
If you pass a promise to push
, Ember Data will not ask the adapter for the data if another attempt to fetch it is made in the interim. When the promise resolves, the underlying object is updated with the new data, and the promise returned by this function is resolved with that object.
For example, recordReference.push(promise)
will be resolved with a record.
Example
let userRef = store.getReference('user', 1); // provide data for reference userRef.push({ data: { id: 1, username: "@user" }}).then(function(user) { userRef.value() === user; });
Defined in addon/-private/system/references/record.js:140
Reloads the record if it is already loaded. If the record is not loaded it will load the record via store.findRecord
Example
let userRef = store.getReference('user', 1); // or trigger a reload userRef.reload().then(...)
Defined in addon/-private/system/references/record.js:42
How the reference will be looked up when it is loaded: Currently this always return identity
to signifying that a record will be loaded by the type
and id
.
Example
const userRef = store.getReference('user', 1); userRef.remoteType(); // 'identity'
Defined in addon/-private/system/references/record.js:98
If the entity referred to by the reference is already loaded, it is present as reference.value
. Otherwise the value returned by this function is null
.
Example
let userRef = store.getReference('user', 1); userRef.value(); // user
© 2017 Yehuda Katz, Tom Dale and Ember.js contributors
Licensed under the MIT License.
https://emberjs.com/api/ember-data/2.14/classes/DS.RecordReference/methods