feat(api): allow passing down test cases to toTestSpecification (#9627)

sheremet-va · web-flow · commit 6f17d5ddf511 · 2026-02-10T12:15:49.000+01:00
diff --git a/docs/api/advanced/test-module.md b/docs/api/advanced/test-module.md
@@ -132,7 +132,9 @@ This is a Vite's [`DevEnvironment`](https://vite.dev/guide/api-environment) that
 ## toTestSpecification <Version>4.1.0</Version> {#totestspecification}
 
 ```ts
-function toTestSpecification(): TestSpecification
+function toTestSpecification(testCases?: TestCase[]): TestSpecification
 ```
 
 Returns a new [test specification](/api/advanced/test-specification) that can be used to filter or run this specific test module.
+
+It accepts an optional array of test cases that should be filtered.
diff --git a/packages/vitest/src/node/reporters/reported-tasks.ts b/packages/vitest/src/node/reporters/reported-tasks.ts
@@ -509,11 +509,11 @@ export class TestModule extends SuiteImplementation {
   /**
    * Returns a new test specification that can be used to filter or run this specific test module.
    */
-  public toTestSpecification(): TestSpecification {
+  public toTestSpecification(testCases?: TestCase[]): TestSpecification {
     const isTypecheck = this.task.meta.typecheck === true
     return this.project.createSpecification(
       this.moduleId,
-      undefined,
+      testCases?.length ? { testIds: testCases.map(t => t.id) } : undefined,
       isTypecheck ? 'typecheck' : undefined,
     )
   }

Original file line number	Diff line number	Diff line change
`@@ -509,11 +509,11 @@ export class TestModule extends SuiteImplementation {`
`509`	`509`	`/**`
`510`	`510`	`* Returns a new test specification that can be used to filter or run this specific test module.`
`511`	`511`	`*/`
`512`		`- public toTestSpecification(): TestSpecification {`
	`512`	`+ public toTestSpecification(testCases?: TestCase[]): TestSpecification {`
`513`	`513`	`const isTypecheck = this.task.meta.typecheck === true`
`514`	`514`	`return this.project.createSpecification(`
`515`	`515`	`this.moduleId,`
`516`		`- undefined,`
	`516`	`+ testCases?.length ? { testIds: testCases.map(t => t.id) } : undefined,`
`517`	`517`	`isTypecheck ? 'typecheck' : undefined,`
`518`	`518`	`)`
`519`	`519`	`}`