Features Test Tags

// vitest.config.ts
import { defineConfig } from 'vitest/config'

export default defineConfig({
  test: {
    tags: [
      { name: 'frontend', description: 'Frontend tests.' },
      { name: 'db', description: 'Database queries.', timeout: 60_000 },
      {
        name: 'flaky',
        retry: process.env.CI ? 3 : 0,
        timeout: 30_000,
        priority: 1, // lower priority number wins on conflicts
      },
    ],
    strictTags: true, // default: error on unknown tags
  },
})

import 'vitest'

declare module 'vitest' {
  interface TestTags {
    tags: 'frontend' | 'backend' | 'db' | 'flaky'
  }
}

import { describe, test } from 'vitest'

test('renders homepage', { tags: ['frontend'] }, () => {})

// Tags inherit from the parent suite
describe('API endpoints', { tags: ['backend'] }, () => {
  test('validates input', { tags: ['validation'] }, () => {
    // has both "backend" (inherited) and "validation"
  })
})

/**
 * @module-tag admin/pages/dashboard
 */
test('dashboard renders', () => {})

test('flaky db test', { tags: ['flaky', 'db'] }) // timeout 30_000 (flaky priority 1), retry 3
test('override', { tags: ['flaky', 'db'], timeout: 120_000 }) // timeout 120_000, retry 3

vitest --tagsFilter "frontend"
vitest --tagsFilter "db && !flaky"
vitest --tagsFilter "(unit || e2e) && !slow"
vitest --tagsFilter "api/*"            # wildcard
vitest --list-tags                     # list defined tags (=json for JSON)

import { beforeAll, TestRunner } from 'vitest'

beforeAll(async () => {
  if (TestRunner.matchesTags(['db'])) {
    await seedDatabase()
  }
})