I recently got the console error `
Error: [ngRepeat:dupes] duplicates in a repeater are not allowed. Use \'track by\' expression to specify unique keys..
It has a disadvantage
,
'track by'
expression tracks by index in the array. It means that as long as the index stays the same, angularjs thinks it's the same object.
So if you replace any object in the array, angularjs think it didn't change because the index in the array is still the same. Because of that the change detection wont trigger when you expect it would.
Take a look at this example
Try to change the name, nothing happens. Remove track by index, it works. add track by item.name, it still works.
There are multiple reasons to avoid track by $index
track by $index
when using one-time bindingstrack by $index
when there is a unique property identifiertrack by $index
track by $index
when using one-time bindingsThe documentation specifically states that track by $index
should be avoided when using one-time bindings.
From the Docs:
Avoid using
track by $index
when the repeated template contains one-time bindings. In such cases, thenth
DOM element will always be matched with thenth
item of the array, so the bindings on that element will not be updated even when the corresponding item changes, essentially causing the view to get out-of-sync with the underlying data.— AngularJS ng-repeat Reference - Tracking and Duplicates
track by $index
when there is a unique property identifierAvoid track by $index
when there is a unique property identifier to work with. When working with objects that are all unique, it is better to let ng-repeat
to use its own tracking instead of overriding with track by $index
.
From the Docs:
If you are working with objects that have a unique identifier property, you should track by this identifier instead of the object instance. Should you reload your data later,
ngRepeat
will not have to rebuild the DOM elements for items it has already rendered, even if the JavaScript objects in the collection have been substituted for new ones. For large collections, this significantly improves rendering performance.— AngularJS ng-repeat Directive API Reference - Tracking
track by $index
I have also seen problems when objects are added and removed from arrays of objects.