packages/platform-server/src/platform_state.ts - main - githubmirror/angular

packages/platform-server/src/platform_state.ts

68 строк2 KB

Alan Agius

refactor(platform-server): replace standard Error with RuntimeError (#69184)

05 июн 2026, 20:20

05 июн 2026, 20:20abfb04a

/**
 * @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 {DOCUMENT} from '@angular/common';
import {
  inject,
  Inject,
  Injectable,
  Injector,
  ɵstartMeasuring as startMeasuring,
  ɵstopMeasuring as stopMeasuring,
  ɵRuntimeError as RuntimeError,
} from '@angular/core';

import {RuntimeErrorCode} from './errors';
import {serializeDocument} from './domino_adapter';
import {ENABLE_DOM_EMULATION} from './tokens';

/**
 * Representation of the current platform state.
 *
 * @publicApi
 */
@Injectable()
export class PlatformState {
  /* @internal */
  _enableDomEmulation = enableDomEmulation(inject(Injector));

  constructor(@Inject(DOCUMENT) private _doc: any) {}

  /**
   * Renders the current state of the platform to string.
   */
  renderToString(): string {
    if (ngDevMode && !this._enableDomEmulation && !window?.document) {
      throw new RuntimeError(
        RuntimeErrorCode.DISABLED_DOM_EMULATION_IN_NON_BROWSER,
        (typeof ngDevMode === 'undefined' || ngDevMode) &&
          'Disabled DOM emulation should only run in browser environments',
      );
    }

    const measuringLabel = 'renderToString';
    startMeasuring(measuringLabel);
    const rendered = this._enableDomEmulation
      ? serializeDocument(this._doc)
      : // In the case we run/test the platform-server in a browser environment
        this._doc.documentElement.outerHTML;
    stopMeasuring(measuringLabel);
    return rendered;
  }

  /**
   * Returns the current DOM state.
   */
  getDocument(): any {
    return this._doc;
  }
}

export function enableDomEmulation(injector: Injector): boolean {
  return injector.get(ENABLE_DOM_EMULATION, true);
}