TestSpecification

TestSpecification 类描述了要作为测试运行的模块及其参数。

你只能通过在测试项目上调用 createSpecification 方法来创建规范：

const specification = project.createSpecification(
  resolve('./example.test.ts'),
  [20, 40], // 可选测试行
)

createSpecification 期望一个已解析的模块 ID。它不会自动解析文件或检查文件是否存在于文件系统中。

taskId

测试模块的 标识符。

project

这引用了测试模块所属的 TestProject。

moduleId

Vite 模块图中的模块 ID。通常，它是一个使用 POSIX 分隔符的绝对文件路径：

'C:/Users/Documents/project/example.test.ts' // ✅
'/Users/mac/project/example.test.ts' // ✅
'C:\\Users\\Documents\\project\\example.test.ts' // ❌

testModule

与规范相关联的 TestModule 实例。如果测试还未加入队列，则将是 undefined。

pool experimental

测试模块将运行的 pool。

DANGER

通过 poolMatchGlob 和 typecheck.enabled，单个测试项目中可以有多个池。这意味着可以有多个规范具有相同的 moduleId 但不同的 pool。在 Vitest 4 中，项目将仅支持单个池，此属性将被移除。

testLines

这是源代码中定义测试文件的行号数组。此字段仅在 createSpecification 方法接收数组时定义。

请注意，如果这些行中的至少一行没有测试，整个测试套件将会失败。以下是一个正确的 testLines 配置示例：

script.js

const specification = project.createSpecification(
  resolve('./example.test.ts'),
  [3, 8, 9],
)

example.test.js

import { test, describe } from 'vitest'

test('verification works')

describe('a group of tests', () => { 
  // ...

  test('nested test')
  test.skip('skipped test')
})

toJSON

function toJSON(): SerializedTestSpecification

toJSON 生成一个 JSON 友好的对象，可以被 浏览器模式 或 Vitest UI 消费。