feat: support test projects

.github/workflows/test.yml

@@ -112,4 +112,4 @@ jobs:
 
       - name: E2E Test
         if: steps.changes.outputs.changed == 'true'
-        run: pnpm run e2e && pnpm run test:example
+        run: pnpm run e2e

e2e/build/index.test.ts

@@ -20,7 +20,7 @@ describe('test build config', () => {
         command: 'rstest',
         args: [
           'run',
-          `fixtures/${name}/index.test.ts`,
+          `fixtures/${name}`,
           '-c',
           `fixtures/${name}/rstest.config.ts`,
         ],

e2e/dom/fixtures/package.json

@@ -4,7 +4,8 @@
   "scripts": {
     "dev": "rsbuild dev --open",
     "build": "rsbuild build",
-    "preview": "rsbuild preview"
+    "preview": "rsbuild preview",
+    "test": "rstest run"
   },
   "dependencies": {
     "react": "^19.1.1",

e2e/dom/fixtures/rstest.config.ts

@@ -4,4 +4,5 @@ import rsbuildConfig from './rsbuild.config';
 export default defineConfig({
   ...(rsbuildConfig as RstestConfig),
   setupFiles: ['./test/setup.ts'],
+  testEnvironment: 'jsdom',
 });

e2e/dom/fixtures/rstest.externals.config.ts

@@ -4,6 +4,7 @@ import rsbuildConfig from './rsbuild.config';
 export default defineConfig({
   ...(rsbuildConfig as RstestConfig),
   setupFiles: ['./test/setup.ts'],
+  testEnvironment: 'jsdom',
   output: {
     externals: [/react/],
   },

e2e/projects/fixtures/packages/client/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@rstest/tests-project-client",
+  "private": true,
+  "scripts": {
+    "dev": "rsbuild dev --open",
+    "build": "rsbuild build",
+    "test": "rstest run",
+    "preview": "rsbuild preview"
+  },
+  "dependencies": {
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1"
+  },
+  "devDependencies": {
+    "@rsbuild/core": "1.5.0-rc.0",
+    "@rsbuild/plugin-react": "^1.3.5",
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.10",
+    "@types/react-dom": "^19.1.7",
+    "jsdom": "^26.1.0",
+    "typescript": "^5.9.2"
+  }
+}

e2e/projects/fixtures/packages/client/rsbuild.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from '@rsbuild/core';
+import { pluginReact } from '@rsbuild/plugin-react';
+
+export default defineConfig({
+  plugins: [pluginReact()],
+});

e2e/projects/fixtures/packages/client/rstest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig, type RstestConfig } from '@rstest/core';
+import rsbuildConfig from './rsbuild.config';
+
+export default defineConfig({
+  ...(rsbuildConfig as RstestConfig),
+  testEnvironment: 'jsdom',
+  setupFiles: ['./test/setup.ts'],
+});

e2e/projects/fixtures/packages/client/src/App.tsx

@@ -0,0 +1,10 @@
+const App = () => {
+  return (
+    <div className="content">
+      <h1>Rsbuild with React</h1>
+      <p>Start building amazing things with Rsbuild.</p>
+    </div>
+  );
+};
+
+export default App;

e2e/projects/fixtures/packages/client/src/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="@rsbuild/core/types" />

e2e/projects/fixtures/packages/client/src/index.tsx

@@ -0,0 +1,13 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+const rootEl = document.getElementById('root');
+if (rootEl) {
+  const root = ReactDOM.createRoot(rootEl);
+  root.render(
+    <React.StrictMode>
+      <App />
+    </React.StrictMode>,
+  );
+}

e2e/projects/fixtures/packages/client/test/App.test.tsx

@@ -0,0 +1,17 @@
+import { expect, test } from '@rstest/core';
+import { render, screen } from '@testing-library/react';
+import App from '../src/App';
+
+test('should render App correctly', async () => {
+  render(<App />);
+
+  const element = screen.getByText('Rsbuild with React');
+
+  expect(element.tagName).toBe('H1');
+
+  expect(element.constructor).toBe(document.defaultView?.HTMLHeadingElement);
+});
+
+test('should get document correctly', () => {
+  expect(global.document).toBeDefined();
+});

e2e/projects/fixtures/packages/client/test/setup.ts

@@ -0,0 +1,4 @@
+import { expect } from '@rstest/core';
+import * as jestDomMatchers from '@testing-library/jest-dom/matchers';
+
+expect.extend(jestDomMatchers);

e2e/projects/fixtures/packages/client/test/test.d.ts

@@ -0,0 +1 @@
+/// <reference types="@testing-library/jest-dom" />

e2e/projects/fixtures/packages/node/src/index.ts

@@ -0,0 +1 @@
+export const sayHi = () => 'hi';

e2e/projects/fixtures/packages/node/test/__snapshots__/index.test.ts.snap

@@ -0,0 +1,3 @@
+// Rstest Snapshot v1
+
+exports[`should generate snapshot correctly 1`] = `"hello world"`;

e2e/projects/fixtures/packages/node/test/index.test.ts

@@ -0,0 +1,13 @@
+import { sayHi } from '../src/index';
+
+it('should test source code correctly', () => {
+  expect(sayHi()).toBe('hi');
+});
+
+it('should can not get document', () => {
+  expect(global.document).toBeUndefined();
+});
+
+it('should generate snapshot correctly', () => {
+  expect('hello world').toMatchSnapshot();
+});

e2e/projects/fixtures/rstest.404.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from '@rstest/core';
+
+export default defineConfig({
+  projects: ['packages/*', '404'],
+  globals: true,
+  setupFiles: ['./setup.ts'],
+});

e2e/projects/fixtures/rstest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from '@rstest/core';
+
+export default defineConfig({
+  projects: ['packages/*'],
+  globals: true,
+  setupFiles: ['./setup.ts'],
+});

e2e/projects/fixtures/setup.ts

@@ -0,0 +1 @@
+throw new Error('root setup file error');

e2e/projects/index.test.ts

@@ -0,0 +1,117 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from '@rstest/core';
+import { runRstestCli } from '../scripts';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+describe('test projects', () => {
+  describe('merge configs', () => {
+    it('should run projects correctly with cli options', async () => {
+      const { cli, expectExecSuccess } = await runRstestCli({
+        command: 'rstest',
+        args: ['run', '--globals'],
+        options: {
+          nodeOptions: {
+            cwd: join(__dirname, 'fixtures'),
+          },
+        },
+      });
+
+      await expectExecSuccess();
+      const logs = cli.stdout.split('\n').filter(Boolean);
+
+      // test log print
+      expect(
+        logs.find((log) => log.includes('packages/node/test/index.test.ts')),
+      ).toBeTruthy();
+      expect(
+        logs.find((log) => log.includes('packages/client/test/App.test.tsx')),
+      ).toBeTruthy();
+    });
+
+    it('should not inherit projects config and run projects failed ', async () => {
+      const { cli } = await runRstestCli({
+        command: 'rstest',
+        args: ['run'],
+        options: {
+          nodeOptions: {
+            cwd: join(__dirname, 'fixtures'),
+          },
+        },
+      });
+
+      await cli.exec;
+      expect(cli.exec.process?.exitCode).toBe(1);
+      const logs = cli.stdout.split('\n').filter(Boolean);
+
+      // test log print
+      expect(
+        logs.find((log) => log.includes('it is not defined')),
+      ).toBeTruthy();
+    });
+  });
+
+  it('should run projects fail when project not found', async () => {
+    const { cli } = await runRstestCli({
+      command: 'rstest',
+      args: ['run', '-c', 'rstest.404.config.ts'],
+      options: {
+        nodeOptions: {
+          cwd: join(__dirname, 'fixtures'),
+        },
+      },
+    });
+
+    await cli.exec;
+    expect(cli.exec.process?.exitCode).toBe(1);
+    const logs = cli.stdout.split('\n').filter(Boolean);
+
+    // test log print
+    expect(
+      logs.find((log) => log.includes(`Can't resolve project "404"`)),
+    ).toBeTruthy();
+  });
+
+  it('should run test failed when test file not found', async () => {
+    const { cli } = await runRstestCli({
+      command: 'rstest',
+      args: ['run', '404-file', '--globals'],
+      options: {
+        nodeOptions: {
+          cwd: join(__dirname, 'fixtures'),
+        },
+      },
+    });
+
+    await cli.exec;
+    expect(cli.exec.process?.exitCode).toBe(1);
+    const logs = cli.stdout.split('\n').filter(Boolean);
+
+    // test log print
+    expect(
+      logs.find((log) => log.includes('No test files found')),
+    ).toBeTruthy();
+  });
+
+  it('should run test success when test file not found with passWithNoTests flag', async () => {
+    const { cli, expectExecSuccess } = await runRstestCli({
+      command: 'rstest',
+      args: ['run', '404-file', '--passWithNoTests', '--globals'],
+      options: {
+        nodeOptions: {
+          cwd: join(__dirname, 'fixtures'),
+        },
+      },
+    });
+
+    await expectExecSuccess();
+    const logs = cli.stdout.split('\n').filter(Boolean);
+
+    // test log print
+    expect(
+      logs.find((log) => log.includes('No test files found')),
+    ).toBeTruthy();
+  });
+});

e2e/watch/index.test.ts

@@ -28,7 +28,7 @@ describe('watch', () => {
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Tests 1 passed');
     expect(cli.stdout).not.toMatch('Test files to re-run:');
-    expect(cli.stdout).toMatch('Run all tests.');
+    expect(cli.stdout).toMatch('Run all tests in project');
 
     // create
     cli.resetStd();
@@ -44,7 +44,7 @@ describe('watch', () => {
 
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Tests 2 passed');
-    expect(cli.stdout).toMatch(/Test files to re-run:\n.*bar\.test\.ts\n\n/);
+    expect(cli.stdout).toMatch(/Test files to re-run.*:\n.*bar\.test\.ts\n\n/);
 
     // update
     cli.resetStd();
@@ -55,7 +55,7 @@ describe('watch', () => {
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Test Files 1 failed');
     expect(cli.stdout).toMatch('✗ bar > bar should be to bar');
-    expect(cli.stdout).toMatch(/Test files to re-run:\n.*bar\.test\.ts\n\n/);
+    expect(cli.stdout).toMatch(/Test files to re-run.*:\n.*bar\.test\.ts\n\n/);
 
     // delete
     cli.resetStd();

e2e/watch/shortcuts.test.ts

@@ -37,7 +37,7 @@ describe('CLI shortcuts', () => {
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Tests 1 failed | 1 passed');
     await cli.waitForStdout('press h to show help');
-    expect(cli.stdout).toMatch('Run all tests.');
+    expect(cli.stdout).toMatch('Run all tests in project');
 
     cli.exec.process!.stdin!.write('h');
 
@@ -51,7 +51,7 @@ describe('CLI shortcuts', () => {
     cli.exec.process!.stdin!.write('a');
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Tests 1 failed | 1 passed');
-    expect(cli.stdout).toMatch('Run all tests.');
+    expect(cli.stdout).toMatch('Run all tests');
 
     cli.exec.kill();
   });
@@ -82,14 +82,14 @@ describe('CLI shortcuts', () => {
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Tests 1 failed | 1 passed');
     await cli.waitForStdout('press h to show help');
-    expect(cli.stdout).toMatch('Run all tests.');
+    expect(cli.stdout).toMatch('Run all tests in project');
     cli.resetStd();
 
     // rerun failed tests
     cli.exec.process!.stdin!.write('f');
     await cli.waitForStdout('Duration');
     expect(cli.stdout).toMatch('Tests 1 failed');
-    expect(cli.stdout).toMatch('Run filtered tests.');
+    expect(cli.stdout).toMatch('Run filtered tests');
 
     cli.exec.kill();
   });

package.json

@@ -6,7 +6,6 @@
     "build": "cross-env NX_DAEMON=false nx run-many -t build --exclude @examples/* @rstest/tests-* --parallel=10",
     "e2e": "cd e2e && pnpm test",
     "test": "rstest",
-    "test:example": "pnpm --filter @examples/* test",
     "change": "changeset",
     "changeset": "changeset",
     "check-dependency-version": "pnpx check-dependency-version-consistency . && echo",

packages/core/rstest.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from '@rstest/core';
+
+export default defineConfig({
+  setupFiles: ['../../scripts/rstest.setup.ts'],
+  globals: true,
+});