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.FilteredRecordArray


Extends: DS.RecordArray
Defined in: packages/ember-data/lib/system/record-arrays/filtered-record-array.js:9
Module: ember-data

Represents a list of records whose membership is determined by the store. As records are created, loaded, or modified, the store evaluates them to determine if they should be part of the record array.


Methods

filterFunction (record) : Boolean

Module: ember-data

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

record
DS.Model
returns
Boolean

true if the record should be in the array

The filterFunction is a function used to test records from the store to determine if they should be part of the record array.

Example

var allPeople = store.peekAll('person');
allPeople.mapBy('name'); // ["Tom Dale", "Yehuda Katz", "Trek Glowacki"]

var people = store.filter('person', function(person) {
  if (person.get('name').match(/Katz$/)) { return true; }
});
people.mapBy('name'); // ["Yehuda Katz"]

var notKatzFilter = function(person) {
  return !person.get('name').match(/Katz$/);
};
people.set('filterFunction', notKatzFilter);
people.mapBy('name'); // ["Tom Dale", "Trek Glowacki"]

save : DS.PromiseArray

Module: ember-data

Inherited from DS.RecordArray 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

Inherited from DS.RecordArray 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

Inherited from DS.RecordArray 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

Inherited from DS.RecordArray 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

Inherited from DS.RecordArray packages/ember-data/lib/system/record-arrays/record-array.js:25

The model type contained by this record array.

On this page


Methods

  • filterFunction
  • 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.