fix: should not trigger dev hooks when building (#4165)

Author: chenjiahan

e2e/cases/plugin-api/plugin-hooks/index.test.ts

@@ -104,6 +104,39 @@ rspackOnlyTest(
   },
 );
 
+rspackOnlyTest(
+  'should run plugin hooks correctly when running build and mode is development',
+  async () => {
+    const { plugin, names } = createPlugin();
+    const rsbuild = await createRsbuild({
+      cwd: __dirname,
+      rsbuildConfig: {
+        mode: 'development',
+        plugins: [plugin],
+      },
+    });
+
+    const buildInstance = await rsbuild.build();
+
+    await buildInstance.close();
+
+    expect(names).toEqual([
+      'ModifyRsbuildConfig',
+      'ModifyEnvironmentConfig',
+      'ModifyBundlerChain',
+      'ModifyBundlerConfig',
+      'BeforeCreateCompiler',
+      'AfterCreateCompiler',
+      'BeforeBuild',
+      'BeforeEnvironmentCompile',
+      'ModifyHTMLTags',
+      'AfterEnvironmentCompile',
+      'AfterBuild',
+      'OnCloseBuild',
+    ]);
+  },
+);
+
 rspackOnlyTest(
   'should run plugin hooks correctly when running startDevServer',
   async ({ page }) => {

packages/compat/webpack/src/createCompiler.ts

@@ -46,7 +46,7 @@ export async function createCompiler(options: InitConfigsOptions) {
     done(stats as Rspack.Stats);
   });
 
-  if (context.normalizedConfig?.mode === 'development') {
+  if (context.command === 'dev') {
     helpers.registerDevHook({
       compiler,
       context,

packages/core/src/createRsbuild.ts

@@ -144,6 +144,8 @@ export async function createRsbuild(
   });
 
   const preview = async (options: PreviewOptions = {}) => {
+    context.command = 'preview';
+
     if (!getNodeEnv()) {
       setNodeEnv('production');
     }
@@ -174,9 +176,12 @@ export async function createRsbuild(
   };
 
   const build: Build = async (...args) => {
+    context.command = 'build';
+
     if (!getNodeEnv()) {
       setNodeEnv('production');
     }
+
     const buildInstance = await providerInstance.build(...args);
     return {
       ...buildInstance,
@@ -188,16 +193,22 @@ export async function createRsbuild(
   };
 
   const startDevServer: StartDevServer = (...args) => {
+    context.command = 'dev';
+
     if (!getNodeEnv()) {
       setNodeEnv('development');
     }
+
     return providerInstance.startDevServer(...args);
   };
 
   const createDevServer: CreateDevServer = (...args) => {
+    context.command = 'dev';
+
     if (!getNodeEnv()) {
       setNodeEnv('development');
     }
+
     return providerInstance.createDevServer(...args);
   };
 

packages/core/src/provider/createCompiler.ts

@@ -57,7 +57,7 @@ export async function createCompiler(options: InitConfigsOptions): Promise<{
     isCompiling = true;
   });
 
-  if (context.normalizedConfig?.mode === 'production') {
+  if (context.command === 'build') {
     compiler.hooks.run.tap('rsbuild:run', logRspackVersion);
   }
 
@@ -113,7 +113,7 @@ export async function createCompiler(options: InitConfigsOptions): Promise<{
     },
   );
 
-  if (context.normalizedConfig?.mode === 'development') {
+  if (context.command === 'dev') {
     registerDevHook({
       context,
       compiler,

packages/core/src/types/context.ts

@@ -44,4 +44,12 @@ export type InternalContext = RsbuildContext & {
   environments: Record<string, EnvironmentContext>;
   /** Only build specified environment. */
   specifiedEnvironments?: string[];
+  /**
+   * The command type.
+   *
+   * - dev: `rsbuild dev` or `rsbuild.startDevServer()`
+   * - build: `rsbuild build` or `rsbuild.build()`
+   * - preview: `rsbuild preview` or `rsbuild.preview()`
+   */
+  command?: 'dev' | 'build' | 'preview';
 };