Today the Ember project is releasing version 4.7 of Ember.js, Ember Data, and Ember CLI.
This release kicks off the 4.8 beta cycle for all sub-projects. We encourage our community (especially addon authors) to help test these beta builds and report any bugs before they are published as a final release in six weeks' time. The ember-try addon is a great way to continuously test your projects against the latest Ember releases.
You can read more about our general release process here:
Ember.js is the core framework for building ambitious web applications.
Changes in Ember.js 4.7
Ember.js 4.7 is an incremental, backwards compatible release of Ember with bug fixes, performance improvements, and minor deprecations.
Ember.js 4.7 introduced 1 bug fix.
Ember.js 4.7 introduced 0 features.
Ember.js 4.7 introduced 0 deprecations.
For more details on changes in Ember.js 4.7, please review the Ember.js 4.7.0 release page.
Ember Data is the official data persistence library for Ember.js applications.
Changes in Ember Data 4.7
Version 4.7 implements a "2.1" cache spec while deprecating the v1 cache spec. This spec differs somewhat from the original 2.0 RFC, an updated RFC specifying the modifications will be published soon. Users looking to migrate to the 2.1 cache should expect that the finalized version of 2.1 enforces that the cache is always a singleton (vs merely allowed to be a singleton), and that data provided to the store and queries to the store from the cache should always contain identifiers in their stable form. This latter point is enforced in 4.7, the former is not yet enforced.
Note: many performance improvements are gated by deprecation removal, meaning that you need to resolve all deprecations for EmberData 4.7 and mark your app as compatible with that version in order to opt in to the fastest codepaths. All applications should observe significant speed improvements when using EmberData 4.7. The below call-outs are in relation to EmberData 4.6.
- Pushing new data into the cache is now ~33% faster
- Accessing the LiveArray (peekAll / findAll) for the first time is now 97% faster
- Initial Access of Related Records is now ~80% faster
- Destroying all records (e.g. also sending an API request) in a loop is 62% faster
- Unloading all records (of all types) is ~98% faster
Read more in the release notes.
Ember Data 4.7 introduced 8 bug fixes and some tests and documentation improvements. Additional details are in the release notes.
- #8089 Unpin yarn for consumers
- #8108 Fix earlier versions of node-14
- #8118 Reopen deprecation should properly pass original arguments
- #8113 Account for multi-options-per-identifer possibility
- #8109 Add optional polyfill for crypto.randomUUID
- #8116 Clear subscriptions once unsubscribed, don't unnecessarily churn on subscriptions
backgroundReloadsshould not affect
- #8159 uuid polyfill logic (@runspired)
Ember Data 4.7 introduced 2 features.
- #7955 Explicit Polymorphic Relationship Support emberjs/rfcs#793
- #8134 The return values of hasMany relationships, peekAll, findAll and query are now proxies to native arrays and as such all native array APIs are now usable. These objects will act fully as if they are native arrays. Restrictions on immutability of the result of peekAll and query still apply (RFC 846).
Ember Data 4.7 introduced 13 deprecations. Additional details are in the release notes.
- #8093 Implement helper deprecations (RFC 742).
- #8092 Deprecate
reopenClassand eager static fields lookups (implements RFC 738 and RFC 741).
- #8084 Eliminate InternalModel, nearly all private API's have undergone significant change, if your app previously used these APIs the most likely refactor is to use a custom model or a custom cache.
- #8115 Implement strict relationships (RFC 739).
For more details on changes in Ember Data 4.7, please review the Ember Data 4.7.1 commits.
Ember CLI is the command line interface for managing and packaging Ember.js applications.
Upgrading Ember CLI
You may upgrade Ember CLI using the
This utility will help you to update your app or addon to the latest Ember CLI version. You will probably encounter merge conflicts, in which the default behavior is to let you resolve conflicts on your own. For more information on the
ember-cli-update project, see the GitHub README.
While it is recommended to keep Ember CLI versions in sync with Ember and Ember Data, this is not required. After updating ember-cli, you can keep your current version(s) of Ember or Ember Data by editing
package.json to revert the changes to the lines containing
Changes in Ember CLI 4.7
Ember CLI 4.7 introduced 1 bug fix.
Ember CLI 4.7 introduced 0 features.
Ember CLI 4.7 introduced 0 deprecations.
For more details on the changes in Ember CLI 4.7 and detailed upgrade instructions, please review the Ember CLI 4.7.0 release page.
As a community-driven open-source project with an ambitious scope, each of these releases serves as a reminder that the Ember project would not have been possible without your continued support. We are extremely grateful to our contributors for their efforts.