class Types/collection:List

Список - коллекция c доступом по индексу.

Примечание

Основные возможности:

последовательный перебор элементов коллекции - поддержка интерфейса Types/collection:IEnumerable;
доступ к элементам коллекции по индексу - поддержка интерфейса Types/collection:IList;
поиск элементов коллекции по значению свойства - поддержка интерфейса Types/collection:IIndexedCollection.

Создадим список, в котором в качестве сырых данных используется plain JSON (адаптер для данных в таком формате используется по умолчанию):

import {List} from 'Types/collection';

const characters = new List({
    items: [{
        id: 1,
        firstName: 'Tom',
        lastName: 'Sawyer'
    }, {
        id: 2,
        firstName: 'Huckleberry',
        lastName: 'Finn'
    }]
});
console.log(characters.at(0).firstName); // 'Tom'
console.log(characters.at(1).firstName); // 'Huckleberry'

Опции

items protected: Элементы списка
versionCallback protected: Обработчик изменения версии; VersionableMixin

Поля

indexer protected: Индексатор элементов.
destroyed: Экземпляр был разрушен; DestroyableMixin
_mediator: Медиатор, отвечающий за связи между сущностями; ManyToManyMixin
options deprecated protected: ReadWriteMixin
getOptions protected: Метод реализован в OptionsToPropertyMixin.; SerializableMixin
instanceNumber protected: Уникальный номер инстанса; SerializableMixin
moduleName protected: Название класса-конструктора.; SerializableMixin

Методы

_addChild protected: Добавляет отношение с другой сущностью; ManyToManyMixin
_checkModuleName protected: Проверяет, что в прототипе указано имя модуля для RequireJS, иначе не будет работать десериализация; SerializableMixin
_childChanged protected: Рекурсивно уведомляет родительские сущности об изменении дочерней; ManyToManyMixin
_clearIndexer protected: Очищает индексатор коллекции
_createMediator protected: Создает посредника для установления отношений с детьми; ManyToManyMixin
_getIndexer protected: Возвращает индексатор коллекции
_getMediator protected: Возвращает посредника для установления отношений с детьми; ManyToManyMixin
_getOptions protected: Возвращает опции объекта; OptionsToPropertyMixin
_getSerializableState protected: Возвращает всё, что нужно сложить в состояние объекта при сериализации, чтобы при десериализации вернуть его в это же состояние; SerializableMixin
_hasMediator protected: Возвращает признак наличия посредника; ManyToManyMixin
_hasSameMediator protected: Возвращает признак наличия одинакового посредника; ManyToManyMixin
_isUnserialized protected: Check if the instance was unserialized.; SerializableMixin
_isValidIndex protected: Проверяет корректность индекса
_itemsToArray protected: Приводит переденные элементы к массиву.
_parentChanged protected: Уведомляет дочерние сущности об изменении родительской; ManyToManyMixin
_reindex protected: Переиндексирует список
_removeChild protected: Удаляет отношение с другой сущностью; ManyToManyMixin
_setMediator protected: Устанавливает посредника для установления отношений с детьми; ManyToManyMixin
_setSerializableState protected: Проверяет сериализованное состояние перед созданием инстанса. Возвращает метод, восстанавливающий состояние объекта после создания инстанса.; SerializableMixin
_splice protected: Вызывает метод splice.
add: Добавляет элемент в список.
При недопустимом at генерируется исключение.; IList
append: Добавляет элементы другой коллекции к концу списка.; IList
assign: Заменяет список другой коллекцией.; IList
at: Возвращает элемент по позиции.
При недопустимом index возвращает undefined.; IList
clear: Очищает список.; IList
clone: Создает новый объект, который является копией текущего экземпляра.; ICloneable
constructor: Конструктор объекта, принимающий набор опций в качестве первого аргумента; OptionsToPropertyMixin
destroy: Разрушает экземпляр; DestroyableMixin
each: Перебирает все элементы коллекции, начиная с первого. Цикл проходит полное количество итераций, его невозможно прервать досрочно.; IEnumerable
fromJSON: Конструирует экземпляр класса из сериализованного состояния; SerializableMixin
getCount: Возвращает количество элементов списка; IList
getEnumerator: Возвращает энумератор для перебора элементов списка.
Пример использования можно посмотреть в модуле Types/collection:IEnumerable.; IEnumerable
getIndex: Возвращает позицию первого вхождения элемента в список.; IList
getIndexByValue: Возвращает индекс первого элемента с указанным значением свойства. Если такого элемента нет - вернет -1.; IIndexedCollection
getIndicesByValue: Возвращает индексы всех элементов с указанным значением свойства. Если таких элементов нет - вернет пустой массив.; IIndexedCollection
getVersion: Возвращает версию объекта.
Версия соответствует некому состоянию объекта и меняется при изменении как то значимых свойств объекта, например для рекорда это будет изменение значений полей.; IVersionable
isEqual: Проверяет эквивалентность текущего объекта другому объекту.; IEquatable
move: Перемещает элемент с одной позиции на другую.
При недопустимом from или to генерируется исключение.; IList
prepend: Добавляет элементы другой коллекции в начало списка.; IList
remove: Удаляет элемент из списка (первый найденный). Элементы, следующие за удаленным, смещаются вверх.; IList
removeAt: Удаляет элемент в указанной позиции. Элементы, следующие за удаленным, смещаются вверх.
При недопустимом index генерируется исключение.; IList
replace: Заменяет элемент в указанной позиции.
При недопустимом at генерируется исключение.; IList
toJSON: Возвращает сериализованный экземпляр класса; SerializableMixin