tracked-toolstracked-built-ins 
This addon provides tracked versions of JavaScript's built-ins:
import {
TrackedObject,
TrackedArray,
TrackedMap,
TrackedSet,
TrackedWeakMap,
TrackedWeakSet,
} from 'tracked-built-ins';
These classes have the same APIs as their native equivalents, but reading from them or writing to them will be tracked, allowing you to use them in your Ember apps and have changes automatically propagate!
Also included is an enhanced version of the @tracked decorator, which
automatically shallow-wraps the native versions of these classes:
import { tracked } from 'tracked-built-ins';
class Foo {
@tracked value = 123;
obj = tracked({});
arr = tracked([]);
map = tracked(Map);
set = tracked(Set);
weakMap = tracked(WeakMap);
weakSet = tracked(WeakSet);
}
Note: This addon does NOT support IE 11 or older browsers. If you need to support them, consider using tracked-maps and sets instead.
Installation
ember install tracked-built-ins
Usage
See the MDN documentation for each class to learn more about it:
All public APIs are the same, with a few exceptions:
new TrackedArray()should receive an array instead of variable number of arguments. This decision was due to the confusing nature ofnew Array()in general, and for symmetry with the othernewAPIs.// bad new TrackedArray(123); new TrackedArray('foo', 'bar', 'baz'); // good new TrackedArray([123]); new TrackedArray(['foo', 'bar', 'baz']);new TrackedObject()returns a copy of the object passed back to it, whereasnew Object()will return the original object. This is to prevent accidentally mutating the original object.let original = {}; let obj = new TrackedObject(original); obj.foo = 123; original.foo; // undefined;Static
ArrayandObjectmethods that do not create a new Array/Object have been omitted. In general, you should use the original static methods for these features, since autotracking has nothing to do with them. The static methods that are supported are:Arrayfromof
ObjectfromEntries
Object.createhas also been omitted, even though it creates an instance, because manual prototype manipulation is an advanced use case in general that is not currently supported.
All types will also register as instanceof their base type, so they can be
used as fully transparent replacements in most circumstances.
Compatibility
- Ember.js v3.28 (LTS) or above
- Embroider v3 and greater or ember-auto-import v2.7.0 and greater
TypeScript
This project follows the current draft of the Semantic Versioning for TypeScript Types specification.
- Currently supported TypeScript versions: 5.5, 5.6, and 5.7
- Compiler support policy: simple majors
- Public API: all published types not in a
-privatemodule are public
Contributing
See the Contributing guide for details.
License
This project is licensed under the MIT License.