/** * @license * Copyright Google LLC 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_DETAILS_PAGE_BASE_URL} from './error_details_base_url'; /** * The list of error codes used in runtime code of the `core` package. * Reserved error code range: 100-999. * * Note: the minus sign denotes the fact that a particular code has a detailed guide on * angular.io. This extra annotation is needed to avoid introducing a separate set to store * error codes which have guides, which might leak into runtime code. * * Full list of available error guides can be found at https://angular.io/errors. */ export const enum RuntimeErrorCode { // Change Detection Errors EXPRESSION_CHANGED_AFTER_CHECKED = -100, RECURSIVE_APPLICATION_REF_TICK = 101, // Dependency Injection Errors CYCLIC_DI_DEPENDENCY = -200, PROVIDER_NOT_FOUND = -201, INVALID_FACTORY_DEPENDENCY = 202, MISSING_INJECTION_CONTEXT = -203, INVALID_INJECTION_TOKEN = 204, INJECTOR_ALREADY_DESTROYED = 205, PROVIDER_IN_WRONG_CONTEXT = 207, MISSING_INJECTION_TOKEN = 208, INVALID_MULTI_PROVIDER = -209, // Template Errors MULTIPLE_COMPONENTS_MATCH = -300, EXPORT_NOT_FOUND = -301, PIPE_NOT_FOUND = -302, UNKNOWN_BINDING = 303, UNKNOWN_ELEMENT = 304, TEMPLATE_STRUCTURE_ERROR = 305, INVALID_EVENT_BINDING = 306, HOST_DIRECTIVE_UNRESOLVABLE = 307, HOST_DIRECTIVE_NOT_STANDALONE = 308, DUPLICATE_DIRECTITVE = 309, HOST_DIRECTIVE_COMPONENT = 310, HOST_DIRECTIVE_UNDEFINED_BINDING = 311, HOST_DIRECTIVE_CONFLICTING_ALIAS = 312, // Bootstrap Errors MULTIPLE_PLATFORMS = 400, PLATFORM_NOT_FOUND = 401, MISSING_REQUIRED_INJECTABLE_IN_BOOTSTRAP = 402, BOOTSTRAP_COMPONENTS_NOT_FOUND = -403, PLATFORM_ALREADY_DESTROYED = 404, ASYNC_INITIALIZERS_STILL_RUNNING = 405, APPLICATION_REF_ALREADY_DESTROYED = 406, RENDERER_NOT_FOUND = 407, // Styling Errors // Declarations Errors // i18n Errors INVALID_I18N_STRUCTURE = 700, MISSING_LOCALE_DATA = 701, // standalone errors IMPORT_PROVIDERS_FROM_STANDALONE = 800, // JIT Compilation Errors // Other INVALID_DIFFER_INPUT = 900, NO_SUPPORTING_DIFFER_FACTORY = 901, VIEW_ALREADY_ATTACHED = 902, INVALID_INHERITANCE = 903, UNSAFE_VALUE_IN_RESOURCE_URL = 904, UNSAFE_VALUE_IN_SCRIPT = 905, MISSING_GENERATED_DEF = 906, TYPE_IS_NOT_STANDALONE = 907, MISSING_ZONEJS = 908, UNEXPECTED_ZONE_STATE = 909, UNSAFE_IFRAME_ATTRS = -910, } /** * Class that represents a runtime error. * Formats and outputs the error message in a consistent way. * * Example: * ``` * throw new RuntimeError( * RuntimeErrorCode.INJECTOR_ALREADY_DESTROYED, * ngDevMode && 'Injector has already been destroyed.'); * ``` * * Note: the `message` argument contains a descriptive error message as a string in development * mode (when the `ngDevMode` is defined). In production mode (after tree-shaking pass), the * `message` argument becomes `false`, thus we account for it in the typings and the runtime logic. */ export class RuntimeError extends Error { constructor(public code: T, message: null|false|string) { super(formatRuntimeError(code, message)); } } /** * Called to format a runtime error. * See additional info on the `message` argument type in the `RuntimeError` class description. */ export function formatRuntimeError( code: T, message: null|false|string): string { // Error code might be a negative number, which is a special marker that instructs the logic to // generate a link to the error details page on angular.io. // We also prepend `0` to non-compile-time errors. const fullCode = `NG0${Math.abs(code)}`; let errorMessage = `${fullCode}${message ? ': ' + message.trim() : ''}`; if (ngDevMode && code < 0) { const addPeriodSeparator = !errorMessage.match(/[.,;!?]$/); const separator = addPeriodSeparator ? '.' : ''; errorMessage = `${errorMessage}${separator} Find more at ${ERROR_DETAILS_PAGE_BASE_URL}/${fullCode}`; } return errorMessage; }