Collection.replace¶
Заменяет элемент коллекции на указанный.
Description¶
Метод replace() заменяет элемент коллекции на указанный. При этом новый элемент помещается в ту же позицию, в которой находился существующий элемент. Успешное выполнение данного метода приводит к возникновению события onReplace. Вместе с этим событием также генерируется событие onChange, которое информирует о наличии любых изменений. Аргументы обеих событий в данном случае будут идентичны.
Syntax¶
Collection.replace(oldItem, newItem)
Parameters¶
Name | Type | Description |
---|---|---|
oldItem |
* | Существующий элемент коллекции, который нужно заменить. |
newItem |
* | Новый элемент коллекции, которым нужно заменить существующий. |
Returns¶
Возвращает true
, если коллекция была изменена, иначе - false
.
Examples¶
var collection = new Collection([ 'A', 'B', 'C' ]);
collection.replace('C', 'D'); // [ 'A', 'B', 'D' ]