Documentation / @ember-data/tracking

@ember-data/tracking deprecated v5.5

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
• Add @warp-drive/ember to tsconfig.json - the types import follows the same pattern (currently this means adding @warp-drive/ember/unstable-preview-types to the types array)
• 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

'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

• buildSignalConfig