Want to upgrade ember to v6? but your app has intense usage of array prototype extensions?
Now you can keep them alive with this addon.
(You should still consider getting rid of the prototype extensions tho).
This addon is not meant for new projects!!!!
// somewhere -- perhaps app/app.js
import '@nullvoxpopuli/legacy-prototype-extensions/array';and that's it.
This library adds the NativeArray methods to Array.prototype again.
It does not use NativeArray, Mixin, or other deprecated Ember APIs to do this.
The methods come from ember-undeprecate-ember-a.
Only addObserver, removeObserver, and cacheFor are implemented here, with @ember/object/observers and @ember/object/internals, because ember-undeprecate-ember-a does not support observers.
The deprecation guide tells you to set EXTEND_PROTOTYPES: false. You can do that, and you do not need to change other code.
If you use A(), you can import it from this library:
import { A } from '@nullvoxpopuli/legacy-prototype-extensions/array';- The methods do not send array observer events (
@array:before/@array:change). Ember can only send these with deprecated APIs. Thus, anArrayProxy(deprecated in Ember 7.4) that wraps a native array does not see changes made with these methods. Tracked templates,computed('arr.[]'),computed('arr.@each.prop'), and observers onlength,[],firstObject, andlastObjectcontinue to update. EmberArray.detect([])andMutableArray.detect([])returnfalse. Before, they returnedtrue, because the mixin was applied toArray.prototype. UseArray.isArrayorisArrayfrom@ember/arrayinstead.addObjectsandremoveObjectsdo not batch their changes. Synchronous observers run one time for each item.- The private
beginPropertyChanges,endPropertyChanges, andhasObserverFormethods are not added. setEachreturnsundefined, as Ember'ssetEachdoes. Versions 0.1.0 and earlier of this library returned the array.