Vitest: teste unit

Ce este Vitest

Vitest e un test runner: găsește fișierele de test (*.test.ts), le rulează și raportează ce a trecut și ce nu. E rapid, înțelege TypeScript și ESM fără configurare și are API-ul compatibil cu Jest (cel mai cunoscut runner).

npm i -D vitest
npx vitest          # mod watch — rerulează la fiecare salvare
npx vitest run      # o singură rulare (CI)

Structura

// src/shared/lib/price.test.ts
import { describe, expect, test } from 'vitest'
import { applyDiscount } from './price'

describe('applyDiscount', () => {
  test('WELCOME10 scade 10%', () => {
    expect(applyDiscount(100, 'WELCOME10')).toBe(90)
  })

  test('cod necunoscut nu schimbă prețul', () => {
    expect(applyDiscount(100, 'NOPE')).toBe(100)
  })
})

• describe grupează teste înrudite.
• test (sau it) — un caz.
• expect(valoare).matcher(așteptat) — verificarea.

Pune testul lângă fișierul testat (colocation) — ușor de găsit, se mută împreună.

Matcher-ele — tipuri și când

expect({ a: 1 }).toBe({ a: 1 })      // ✗ obiecte diferite
expect({ a: 1 }).toEqual({ a: 1 })   // ✓ același conținut
expect(() => parseAge(-1)).toThrow('Vârstă invalidă')
await expect(loadUser(1)).resolves.toEqual({ id: 1 })

Mock-uri

Un mock e o funcție falsă care înlocuiește o dependență (API, timp, random) ca testul să fie rapid și determinist.

import { vi } from 'vitest'

const onSave = vi.fn()                       // funcție spion
render(<Form onSave={onSave} />)
// ... userul trimite formularul
expect(onSave).toHaveBeenCalledWith({ email: 'a@x.ro' })

vi.useFakeTimers()                           // controlezi timpul
vi.advanceTimersByTime(300)                  // ex. pentru debounce

Nu exagera cu mock-urile: cu cât mock-uiești mai mult, cu atât testezi mai puțin din realitate. Pentru request-uri HTTP, MSW interceptează la nivel de rețea — codul rămâne neatins.

Setup cu Next.js

Next are un ghid oficial pentru Vitest (cu @vitejs/plugin-react și jsdom pentru componente). Atenție: Server Components async nu se testează încă bine unit — pentru ele, folosește E2E.

Pe scurt

• Vitest rulează *.test.ts; describe / test / expect.
• toBe pentru primitive, toEqual pentru obiecte.
• vi.fn și fake timers pentru dependențe; mock-uiește cât mai puțin.

Surse oficiale

• Vitest — Getting Started
• Vitest — expect API
• Vitest — Mocking
• Next.js — Setting up Vitest