home
  • Blog
  • Home
  • Projects
    • Ember
    • EmberData
    • Ember CLI
1.13
  • Packages
    • ember-data
  • Namespaces
    • DS
    • Ember.Date
  • Classes
    • DS.AbortError
    • DS.ActiveModelAdapter
    • DS.ActiveModelSerializer
    • DS.Adapter
    • DS.AdapterError
    • DS.AdapterPopulatedRecordArray
    • DS.BooleanTransform
    • DS.BuildURLMixin
    • DS.DateTransform
    • DS.EmbeddedRecordsMixin
    • DS.Errors
    • DS.FilteredRecordArray
    • DS.FixtureAdapter
    • DS.InternalModel
    • DS.InvalidError
    • DS.JSONAPIAdapter
    • DS.JSONAPISerializer
    • DS.JSONSerializer
    • DS.ManyArray
    • DS.Model
    • DS.NumberTransform
    • DS.PromiseArray
    • DS.PromiseManyArray
    • DS.PromiseObject
    • DS.RESTAdapter
    • DS.RESTSerializer
    • DS.RecordArray
    • DS.RootState
    • DS.Serializer
    • DS.Store
    • DS.StringTransform
    • DS.TimeoutError
    • DS.Transform

Class DS.RecordArray


Extends: Ember.ArrayProxy
Uses: Ember.Evented
Defined in: packages/ember-data/lib/system/record-arrays/record-array.js:11
Module: ember-data

A record array is an array that contains records of a certain type. The record array materializes records as needed when they are retrieved for the first time. You should not create record arrays yourself. Instead, an instance of DS.RecordArray or its subclasses will be returned by your application's store in response to queries.


Methods

save : DS.PromiseArray

Module: ember-data

Defined in packages/ember-data/lib/system/record-arrays/record-array.js:151

returns
DS.PromiseArray

promise

Saves all of the records in the RecordArray.

Example

var messages = store.peekAll('message');
messages.forEach(function(message) {
  message.set('hasBeenSeen', true);
});
messages.save();

update

Module: ember-data

Defined in packages/ember-data/lib/system/record-arrays/record-array.js:99

Used to get the latest version of all of the records in this array from the adapter.

Example

var people = store.peekAll('person');
people.get('isUpdating'); // false
people.update();
people.get('isUpdating'); // true

Properties

isLoaded

Module: ember-data

Defined in packages/ember-data/lib/system/record-arrays/record-array.js:45

The flag to signal a RecordArray is finished loading data.

Example

var people = store.peekAll('person');
people.get('isLoaded'); // true

isUpdating

Module: ember-data

Defined in packages/ember-data/lib/system/record-arrays/record-array.js:59

The flag to signal a RecordArray is currently loading data.

Example

var people = store.peekAll('person');
people.get('isUpdating'); // false
people.update();
people.get('isUpdating'); // true

type

Module: ember-data

Defined in packages/ember-data/lib/system/record-arrays/record-array.js:25

The model type contained by this record array.

On this page


Methods

  • save
  • update

Properties

  • isLoaded
  • isUpdating
  • type
Team Sponsors Security Legal Branding Community Guidelines
Twitter GitHub Discord Mastodon

If you want help you can contact us by email, open an issue, or get realtime help by joining the Ember Discord.

© Copyright 2025 - Tilde Inc.
Ember.js is free, open source and always will be.


Ember is generously supported by
blue Created with Sketch.