packages/core/src/ng_reflect.ts - main - githubmirror/angular

packages/core/src/ng_reflect.ts
69 строк2 KB
SkyZeroZx
refactor(core): remove redundant `providedIn: 'root'` from injection tokens
04 ноя 2025, 03:31
04 ноя 2025, 03:3164efbc5
/**
 * @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.dev/license
 */

import {EnvironmentProviders, InjectionToken, makeEnvironmentProviders} from './di/index';

/** Defines the default value of the `NG_REFLECT_ATTRS_FLAG` flag. */
export const NG_REFLECT_ATTRS_FLAG_DEFAULT = false;

/**
 * Defines an internal flag that indicates whether the runtime code should be
 * producing `ng-reflect-*` attributes.
 */
export const NG_REFLECT_ATTRS_FLAG = new InjectionToken<boolean>(
  typeof ngDevMode === 'undefined' || ngDevMode ? 'NG_REFLECT_FLAG' : '',
  {
    factory: () => NG_REFLECT_ATTRS_FLAG_DEFAULT,
  },
);

/**
 * Enables the logic to produce `ng-reflect-*` attributes on elements with bindings.
 *
 * Note: this is a dev-mode only setting and it will have no effect in production mode.
 * In production mode, the `ng-reflect-*` attributes are *never* produced by Angular.
 *
 * Important: using and relying on the `ng-reflect-*` attributes is not recommended,
 * they are deprecated and only present for backwards compatibility. Angular will stop
 * producing them in one of the future versions.
 *
 * @publicApi
 */
export function provideNgReflectAttributes(): EnvironmentProviders {
  const providers =
    typeof ngDevMode === 'undefined' || ngDevMode
      ? [
          {
            provide: NG_REFLECT_ATTRS_FLAG,
            useValue: true,
          },
        ]
      : [];
  return makeEnvironmentProviders(providers);
}

export function normalizeDebugBindingName(name: string) {
  // Attribute names with `$` (eg `x-y$`) are valid per spec, but unsupported by some browsers
  name = camelCaseToDashCase(name.replace(/[$@]/g, '_'));
  return `ng-reflect-${name}`;
}

const CAMEL_CASE_REGEXP = /([A-Z])/g;

function camelCaseToDashCase(input: string): string {
  return input.replace(CAMEL_CASE_REGEXP, (...m: any[]) => '-' + m[1].toLowerCase());
}

export function normalizeDebugBindingValue(value: any): string {
  try {
    // Limit the size of the value as otherwise the DOM just gets polluted.
    return value != null ? value.toString().slice(0, 30) : value;
  } catch (e) {
    return '[ERROR] Exception while trying to serialize the value';
  }
}