Ember.Debug Class
Item Index
Methods
- registerDeprecationHandler static
- registerWarnHandler static
Methods
registerDeprecationHandler
-
handler
Allows for runtime registration of handler functions that override the default deprecation behavior. Deprecations are invoked by calls to Ember.deprecate. The following example demonstrates its usage by registering a handler that throws an error if the message contains the word "should", otherwise defers to the default handler.
Ember.Debug.registerDeprecationHandler((message, options, next) => {
if (message.indexOf('should') !== -1) {
throw new Error(Deprecation message with should: ${message}
);
} else {
// defer to whatever handler was registered before this one
next(message, options);
}
});
The handler function takes the following arguments:
-
message
- The message received from the deprecation call. -
options
- An object passed in with the deprecation call containing additional information including: -
id
- An id of the deprecation in the form ofpackage-name.specific-deprecation
. -
until
- The Ember version number the feature and deprecation will be removed in. -
next
- A function that calls into the previously registered handler.
Parameters:
-
handler
FunctionA function to handle deprecation calls.
registerWarnHandler
-
handler
Allows for runtime registration of handler functions that override the default warning behavior. Warnings are invoked by calls made to Ember.warn. The following example demonstrates its usage by registering a handler that does nothing overriding Ember's default warning behavior.
// next is not called, so no warnings get the default behavior
Ember.Debug.registerWarnHandler(() => {});
The handler function takes the following arguments:
-
message
- The message received from the warn call. -
options
- An object passed in with the warn call containing additional information including: -
id
- An id of the warning in the form ofpackage-name.specific-warning
. -
next
- A function that calls into the previously registered handler.
Parameters:
-
handler
FunctionA function to handle warnings.