Skip to content
module@ember-data/tracking/index

@ember-data/tracking deprecated v5.5 deprecated ​

Using WarpDrive with EmberJS requires configuring it to use Ember's reactivity system.

WARNING

The use of the package @ember-data/tracking is now deprecated. It historically provided the bindings into Ember's reactivity system.

This package is no longer needed as the configuration is now provided by the package @warp-drive/ember.

To resolve this deprecation, follow these steps:

1. Remove @ember-data/tracking ​

  • Remove @ember-data/tracking from package.json (if using ember-data this may not be present)
  • Remove type imports for @ember-data/tracking from tsconfig.json
  • If using untracked, change to using untrack from @glimmer/validator

2. Add @warp-drive/ember ​

  • Add @warp-drive/ember to package.json - the version to install should match the version of ember-data or @ember-data/store
  • Do NOT add @warp-drive/ember to tsconfig.json - the types in this package install automatically, you can remove any entry for this if it is there
  • Add import '@warp-drive/ember/install'; to the top of your app.js or app.ts file

3. Clear the deprecation ​

Once the above steps are complete, the deprecation can be silenced and the automatic fallback registration of reactivity from @ember-data/tracking can be removed by updating your WarpDrive Build Config in your ember-cli-build file.

ember-cli-build.js
js
'use strict';
const EmberApp = require('ember-cli/lib/broccoli/ember-app');
const { compatBuild } = require('@embroider/compat');

module.exports = async function (defaults) {
  const { setConfig } = await import('@warp-drive/build-config'); 
  const { buildOnce } = await import('@embroider/vite');
  const app = new EmberApp(defaults, {});

  setConfig(app, __dirname, { 
    // this should be the most recent <major>.<minor> version for
    // which all deprecations have been fully resolved
    // and should be updated when that changes
    compatWith: '4.12'
    deprecations: {
      // ... list individual deprecations that have been resolved here
      DEPRECATE_TRACKING_PACKAGE: false
    }
  });

  return compatBuild(app, buildOnce);
};

Deprecated ​

in version 5.5.0

Functions ​

Released under the MIT License.