packages/angular_devkit/build_webpack/src/builders/webpack-dev-server/index.ts - main - githubmirror/angular-cli

packages/angular_devkit/build_webpack/src/builders/webpack-dev-server/index.ts
145 строк5 KB
Alan Agius
build: update dependency webpack-dev-server to v6
03 авг 2026, 16:42
03 авг 2026, 16:425c8a055
/**
 * @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 { Builder, BuilderContext, createBuilder } from '@angular-devkit/architect';
import assert from 'node:assert';
import { resolve as pathResolve } from 'node:path';
import { Observable, from, isObservable, of, switchMap } from 'rxjs';
import type webpack from 'webpack';
import type WebpackDevServer from 'webpack-dev-server';
import type { Configuration } from 'webpack-dev-server';
import { getEmittedFiles, getWebpackConfig } from '../../utils';
import { BuildResult, WebpackFactory, WebpackLoggingCallback } from '../webpack';
import { Schema as WebpackDevServerBuilderSchema } from './schema';

export type WebpackDevServerFactory = typeof WebpackDevServer;

export type DevServerBuildOutput = BuildResult & {
  port: number;
  family: string;
  address: string;
};

/**
 * @deprecated Part of Angular's Webpack support deprecation. Use `@angular/build` APIs instead.
 * Deprecated since v22.
 */
export function runWebpackDevServer(
  config: webpack.Configuration,
  context: BuilderContext,
  options: {
    shouldProvideStats?: boolean;
    devServerConfig?: Configuration;
    logging?: WebpackLoggingCallback;
    webpackFactory?: WebpackFactory;
    webpackDevServerFactory?: WebpackDevServerFactory;
  } = {},
): Observable<DevServerBuildOutput> {
  const createWebpack = (c: webpack.Configuration) => {
    if (options.webpackFactory) {
      const result = options.webpackFactory(c);
      if (isObservable(result)) {
        return result;
      } else {
        return of(result);
      }
    } else {
      return from(import('webpack').then((mod) => mod.default(c)));
    }
  };

  const {
    logging: log = (stats, config) => {
      if (config.stats !== false) {
        const statsOptions = config.stats === true ? undefined : config.stats;
        context.logger.info(stats.toString(statsOptions));
      }
    },
    shouldProvideStats = true,
  } = options;

  return createWebpack({ ...config, watch: false }).pipe(
    switchMap(async (webpackCompiler) => {
      return [
        webpackCompiler,
        options.webpackDevServerFactory ?? (await import('webpack-dev-server')).default,
      ] as unknown as [webpack.Compiler | null, WebpackDevServerFactory];
    }),
    switchMap(
      ([webpackCompiler, webpackDevServerFactory]) =>
        new Observable<DevServerBuildOutput>((obs) => {
          assert(webpackCompiler, 'Webpack compiler factory did not return a compiler instance.');

          const devServerConfig = options.devServerConfig || config.devServer || {};
          devServerConfig.host ??= 'localhost';

          let result: Partial<DevServerBuildOutput>;
          const statsOptions = typeof config.stats === 'boolean' ? undefined : config.stats;

          webpackCompiler.hooks.done.tap('build-webpack', (stats) => {
            // Log stats.
            log(stats, config);
            obs.next({
              ...result,
              webpackStats: shouldProvideStats ? stats.toJson(statsOptions) : undefined,
              emittedFiles: getEmittedFiles(stats.compilation),
              success: !stats.hasErrors(),
              outputPath: stats.compilation.outputOptions.path,
            } as unknown as DevServerBuildOutput);
          });

          const devServer = new webpackDevServerFactory(devServerConfig, webpackCompiler);
          devServer.startCallback((err) => {
            if (err) {
              obs.error(err);

              return;
            }

            const address = devServer.server?.address();
            if (!address) {
              obs.error(new Error(`Dev-server address info is not defined.`));

              return;
            }

            result = {
              success: true,
              port: typeof address === 'string' ? 0 : address.port,
              family: typeof address === 'string' ? '' : address.family,
              address: typeof address === 'string' ? address : address.address,
            };
          });

          // Teardown logic. Close the server when unsubscribed from.
          return () => {
            devServer.stopCallback(() => {});
            webpackCompiler.close(() => {});
          };
        }),
    ),
  );
}

const builder: Builder<WebpackDevServerBuilderSchema> = createBuilder<
  WebpackDevServerBuilderSchema,
  DevServerBuildOutput
>((options, context) => {
  context.logger.warn(
    'The "@angular-devkit/build-webpack:webpack-dev-server" builder is deprecated as part of Angular\'s Webpack support deprecation. ' +
      'Use "@angular/build" instead.',
  );

  const configPath = pathResolve(context.workspaceRoot, options.webpackConfig);

  return from(getWebpackConfig(configPath)).pipe(
    switchMap((config) => runWebpackDevServer(config, context)),
  );
});

export default builder;