77fd91d615
ErrorHandler can not throw errors because it will unsubscribe itself from the error stream. Zones captures errors and feed it into NgZone, which than has a Rx Observable to feed it into ErrorHandler. If the ErroHandler throws, then Rx will teardown the observable which in essence causes the ErrorHandler to be removed from the error handling. This implies that the ErrorHandler can never throw errors. Closes #14949 Closes #15182 Closes #14316
96 lines
2.4 KiB
TypeScript
96 lines
2.4 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google Inc. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {ERROR_ORIGINAL_ERROR, getDebugContext, getErrorLogger, getOriginalError} from './errors';
|
|
|
|
|
|
|
|
/**
|
|
* @whatItDoes Provides a hook for centralized exception handling.
|
|
*
|
|
* @description
|
|
*
|
|
* The default implementation of `ErrorHandler` prints error messages to the `console`. To
|
|
* intercept error handling, write a custom exception handler that replaces this default as
|
|
* appropriate for your app.
|
|
*
|
|
* ### Example
|
|
*
|
|
* ```
|
|
* class MyErrorHandler implements ErrorHandler {
|
|
* handleError(error) {
|
|
* // do something with the exception
|
|
* }
|
|
* }
|
|
*
|
|
* @NgModule({
|
|
* providers: [{provide: ErrorHandler, useClass: MyErrorHandler}]
|
|
* })
|
|
* class MyModule {}
|
|
* ```
|
|
*
|
|
* @stable
|
|
*/
|
|
export class ErrorHandler {
|
|
/**
|
|
* @internal
|
|
*/
|
|
_console: Console = console;
|
|
|
|
constructor(
|
|
/**
|
|
* @deprecated since v4.0 parameter no longer has an effect, as ErrorHandler will never
|
|
* rethrow.
|
|
*/
|
|
deprecatedParameter?: boolean) {}
|
|
|
|
handleError(error: any): void {
|
|
const originalError = this._findOriginalError(error);
|
|
const context = this._findContext(error);
|
|
// Note: Browser consoles show the place from where console.error was called.
|
|
// We can use this to give users additional information about the error.
|
|
const errorLogger = getErrorLogger(error);
|
|
|
|
errorLogger(this._console, `ERROR`, error);
|
|
if (originalError) {
|
|
errorLogger(this._console, `ORIGINAL ERROR`, originalError);
|
|
}
|
|
if (context) {
|
|
errorLogger(this._console, 'ERROR CONTEXT', context);
|
|
}
|
|
}
|
|
|
|
/** @internal */
|
|
_findContext(error: any): any {
|
|
if (error) {
|
|
return getDebugContext(error) ? getDebugContext(error) :
|
|
this._findContext(getOriginalError(error));
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/** @internal */
|
|
_findOriginalError(error: Error): any {
|
|
let e = getOriginalError(error);
|
|
while (e && getOriginalError(e)) {
|
|
e = getOriginalError(e);
|
|
}
|
|
|
|
return e;
|
|
}
|
|
}
|
|
|
|
export function wrappedError(message: string, originalError: any): Error {
|
|
const msg =
|
|
`${message} caused by: ${originalError instanceof Error ? originalError.message: originalError }`;
|
|
const error = Error(msg);
|
|
(error as any)[ERROR_ORIGINAL_ERROR] = originalError;
|
|
return error;
|
|
}
|