perf: pre-filter test projects to avoid unnecessary builds (#1092)

9aoy · web-flow · commit 45a6aa9cb78b · 2026-03-25T11:30:09.000+08:00
diff --git a/packages/core/src/core/listTests.ts b/packages/core/src/core/listTests.ts
@@ -73,6 +73,7 @@ const collectNodeTests = async ({
     globTestSourceEntries,
     setupFiles,
     globalSetupFiles,
+    nodeProjects,
   );
 
   const { getRsbuildStats, closeServer } = await createRsbuildServer({
diff --git a/packages/core/src/core/rsbuild.ts b/packages/core/src/core/rsbuild.ts
@@ -11,6 +11,7 @@ import path from 'pathe';
 import type {
   EntryInfo,
   NormalizedProjectConfig,
+  ProjectContext,
   RstestContext,
 } from '../types';
 import { isDebug } from '../utils';
@@ -65,16 +66,23 @@ export const prepareRsbuild = async (
   globTestSourceEntries: (name: string) => Promise<Record<string, string>>,
   setupFiles: Record<string, Record<string, string>>,
   globalSetupFiles: Record<string, Record<string, string>>,
+  /**
+   * Explicit list of node-mode projects to include in the Rsbuild instance.
+   * When provided, only these projects will be compiled.
+   */
+  targetNodeProjects?: ProjectContext[],
 ): Promise<RsbuildInstance> => {
   const {
     command,
     normalizedConfig: { isolate, dev = {}, coverage, pool },
   } = context;
 
   // Filter out browser mode projects - this rsbuild is for node mode only
-  const projects = context.projects.filter(
-    (project) => !project.normalizedConfig.browser.enabled,
-  );
+  const projects = targetNodeProjects?.length
+    ? targetNodeProjects
+    : context.projects.filter(
+        (project) => !project.normalizedConfig.browser.enabled,
+      );
   const debugMode = isDebug();
 
   RsbuildLogger.level = debugMode ? 'verbose' : 'error';
diff --git a/packages/core/src/core/runTests.ts b/packages/core/src/core/runTests.ts
@@ -142,7 +142,24 @@ export async function runTests(context: Rstest): Promise<void> {
   let browserProjectsToRun = browserProjects;
   let nodeProjectsToRun = nodeProjects;
 
-  if (shard) {
+  // In non-watch mode, proactively skip projects with no test files to avoid unnecessary builds
+  if (!isWatchMode) {
+    // Populate entries cache for all projects
+    await Promise.all(
+      allProjects.map((p) => globTestSourceEntries(p.environmentName)),
+    );
+
+    const hasEntries = (env: string) =>
+      Object.keys(entriesCache.get(env)?.entries || {}).length > 0;
+
+    browserProjectsToRun = browserProjects.filter((p) =>
+      hasEntries(p.environmentName),
+    );
+    nodeProjectsToRun = nodeProjects.filter((p) =>
+      hasEntries(p.environmentName),
+    );
+  } else if (shard) {
+    // In watch mode with sharding, only run projects that have sharded entries
     browserProjectsToRun = browserProjects.filter((p) => {
       return (
         Object.keys(entriesCache.get(p.environmentName)?.entries || {}).length >
@@ -232,6 +249,7 @@ export async function runTests(context: Rstest): Promise<void> {
     globTestSourceEntries,
     setupFiles,
     globalSetupFiles,
+    projects,
   );
 
   const { getRsbuildStats, closeServer } = await createRsbuildServer({
