diff

• 类型: string
• 命令行终端: --diff=<path>

DiffOptions 对象或导出 DiffOptions 的模块路径。适用于想要自定义差异显示的场景。

Vitest 差异渲染底层使用 @vitest/pretty-format，其中部分 DiffOptions 会透传给 pretty-format 配置，其余参数则直接影响差异渲染行为。

例如，作为配置对象：

import { defineConfig } from 'vitest/config'
import c from 'picocolors'

export default defineConfig({
  test: {
    diff: {
      aIndicator: c.bold('--'),
      bIndicator: c.bold('++'),
      omitAnnotationLines: true,
    },
  },
})

或者作为模块：

vitest.config.js

import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    diff: './vitest.diff.ts',
  },
})

vitest.diff.ts

import type { DiffOptions } from 'vitest'
import c from 'picocolors'

export default {
  aIndicator: c.bold('--'),
  bIndicator: c.bold('++'),
  omitAnnotationLines: true,
} satisfies DiffOptions

diff.expand

• 类型: boolean
• 默认值: true
• 命令行终端: --diff.expand=false

展开所有公共行。

diff.truncateThreshold

• 类型: number
• 默认值: 0
• 命令行终端: --diff.truncateThreshold=<path>

差异结果的最大显示长度。超过此阈值的差异将被截断。默认值 0 表示不截断。

diff.truncateAnnotation

• 类型: string
• 默认值: '... Diff result is truncated'
• 命令行终端: --diff.truncateAnnotation=<annotation>

如果差异结果被截断，在末尾输出的注释。

diff.truncateAnnotationColor

• 类型: DiffOptionsColor = (arg: string) => string
• 默认值: noColor = (string: string): string => string

截断注释的颜色，默认无颜色输出。

diff.printBasicPrototype

• 类型: boolean
• 默认值: false

在差异输出中打印基本原型 Object 和 Array。

diff.maxDepth

• 类型: number
• 默认值: 20 (或比较不同类型时为 8)

打印嵌套对象时递归的最大深度。