adev/src/app/editor/node-runtime-state.service.ts - main - githubmirror/angular

adev/src/app/editor/node-runtime-state.service.ts
87 строк2 KB
Matthieu Riegler
docs(docs-infra): Use `@Service` instead of `@Injectable`
23 апр 2026, 21:21
23 апр 2026, 21:217414352
/*!
 * @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 {signal, Service} from '@angular/core';
import {isIos} from '@angular/docs';

import {LoadingStep} from './enums/loading-steps';
import {OUT_OF_MEMORY_MSG} from './node-runtime-errors';

export const MAX_RECOMMENDED_WEBCONTAINERS_INSTANCES = 3;
export const WEBCONTAINERS_COUNTER_KEY = 'numberOfWebcontainers';

export type NodeRuntimeError = {
  message: string | undefined;
  type: ErrorType | undefined;
};

export enum ErrorType {
  UNKNOWN,
  COOKIES,
  OUT_OF_MEMORY,
  UNSUPPORTED_BROWSER_ENVIRONMENT,
}

@Service()
export class NodeRuntimeState {
  private readonly _loadingStep = signal<number>(LoadingStep.NOT_STARTED);
  loadingStep = this._loadingStep.asReadonly();

  private readonly _isResetting = signal(false);
  readonly isResetting = this._isResetting.asReadonly();

  private readonly _error = signal<NodeRuntimeError | undefined>(undefined);
  readonly error = this._error.asReadonly();

  constructor() {
    this.checkUnsupportedEnvironment();
  }

  setLoadingStep(step: LoadingStep): void {
    this._loadingStep.set(step);
  }

  setIsResetting(isResetting: boolean): void {
    this._isResetting.set(isResetting);
  }

  setError({message, type}: NodeRuntimeError) {
    type ??= this.getErrorType(message);
    this._error.set({message, type});
    this.setLoadingStep(LoadingStep.ERROR);
  }

  private getErrorType(message: NodeRuntimeError['message']) {
    if (message?.includes(OUT_OF_MEMORY_MSG)) {
      return ErrorType.OUT_OF_MEMORY;
    }

    if (message?.toLowerCase().includes('service worker')) {
      return ErrorType.COOKIES;
    }

    return ErrorType.UNKNOWN;
  }

  /**
   * This method defines whether the current environment is compatible
   * with the NodeRuntimeSandbox. The embedded editor requires significant
   * CPU and memory resources and can not be ran in all browsers/devices. More
   * specifically, mobile devices are affected by this, so for the best user
   * experience (to avoid crashes), we disable the NodeRuntimeSandbox and
   * recommend using desktop.
   */
  private checkUnsupportedEnvironment(): void {
    if (isIos) {
      this.setError({
        message: 'Unsupported environment',
        type: ErrorType.UNSUPPORTED_BROWSER_ENVIRONMENT,
      });
    }
  }
}