« All deprecation guides

Deprecation Guide for Ember debug function options

until: 3.0.0
id: ember-debug-function-options

Starting in Ember 2.1 various debug functions now require a third argument (commonly called options).

id is required by all methods listed below, and the deprecation related methods also require an until property.

  • Ember.deprecate
  • Ember.deprecateFunc
  • Ember.computed.deprecatingAlias
  • Ember.warn

The id property is intended to allow runtime debug handlers to uniquely identify the source, and the until property is used to indicate the future version when the deprecated behavior will no longer exist.

The goal of these changes is to allow tools like ember-cli-deprecation-workflow to make managing these deprecations and warnings much easier (by matching on the id instead of the full deprecation/warn message).