Φόρτωση περιεχομένου...
Φόρτωση περιεχομένου...
Εγκατάσταση Vitest 5, describe/it/expect, toBe εναντίον toEqual, async resolves και εκτέλεση μίας φοράς με vitest run.
Το Vitest 5 (τρέχουσα έκδοση 5.0.5 στο npm) είναι το de facto unit runner για Vite/Next.js projects: γράφετε σε TypeScript χωρίς build step, έχει watch mode ακαριαίο και API συμβατό με το Jest (describe/it/expect). Εδώ το στήνετε για pure logic.
npm install vitest@5.0.5 --save-dev// src/lib/xp.test.ts
import { describe, expect, it } from 'vitest';
function levelForXp(xp: number): number {
if (xp < 0) throw new Error('negative xp');
return Math.floor(xp / 100) + 1;
}
describe('levelForXp', () => {
it('ξεκινά από level 1', () => {
expect(levelForXp(0)).toBe(1);
});
it('ανεβαίνει κάθε 100 xp', () => {
expect(levelForXp(250)).toBe(3);
});
it('απορρίπτει αρνητικό xp', () => {
expect(() => levelForXp(-5)).toThrow('negative xp');
});
});Εκτέλεση μίας φοράς (αυτό που τρέχει το CI):
npx vitest runΧωρίς το run, το Vitest ξεκινά σε watch mode όταν τρέχει σε διαδραστικό terminal — ιδανικό τοπικά. Στο CI (όταν ορίζεται η μεταβλητή CI, όπως στο GitHub Actions) τρέχει αυτόματα μία φορά, αλλά το vitest run το κάνει ρητό σε κάθε περιβάλλον. Κανόνας: τοπικά σκέτο vitest, στο CI πάντα vitest run.
Σημείωση: η describe είναι συνάρτηση που ομαδοποιεί tests (όπως και οι it/test) — γι' αυτό το typeof describe επιστρέφει 'function'. Αν ο τελεστής typeof σας είναι άγνωστος, δείτε πρώτα το μάθημα Τιμές, Τύποι & Συναρτήσεις.
toBe: ταυτότητα αναφοράς (Object.is) — για primitives (αριθμούς, strings, booleans).toEqual: δομική ισότητα — για objects και arrays.expect({ a: 1 }).toEqual({ a: 1 }); // περνάει — ίδια δομή
expect({ a: 1 }).toBe({ a: 1 }); // ΑΠΟΤΥΓΧΑΝΕΙ — διαφορετικές αναφορέςΌταν βλέπετε "expected {…} to be {…} // Object.is equality", στο 99% των περιπτώσεων θέλατε toEqual.
import { expect, it, vi } from 'vitest';
async function fetchLessonTitle(id: string): Promise<string> {
const res = await fetch('https://api.example.com/lessons/' + id);
if (!res.ok) throw new Error('HTTP ' + res.status);
const data = await res.json();
return data.title;
}
it('επιστρέφει τον τίτλο όταν το API απαντά 200', async () => {
const fake = { title: 'Intro' };
vi.stubGlobal('fetch', vi.fn(async () => ({ ok: true, json: async () => fake })));
try {
await expect(fetchLessonTitle('1')).resolves.toBe('Intro');
} finally {
vi.unstubAllGlobals();
}
});Το .resolves ξετυλίγει το promise μέσα στο assertion — χωρίς αυτό συγκρίνετε ένα εκκρεμές promise. Το stubGlobal αντικαθιστά το boundary (το global fetch), όχι τη συνάρτηση που τεστάρετε — περισσότερα στην Ενότητα 3.
Το coverage απαντά «ποιες γραμμές εκτέλεσαν τα tests» — όχι «τι αποδείξατε», αλλά πού δεν κοιτάξατε καθόλου:
# Lockstep με το vitest@5.0.5 του μαθήματος
npm install @vitest/coverage-v8@5.0.5 --save-dev
npx vitest run --coverage// vitest.config.ts — αποτυχία κάτω από 80% γραμμές/συναρτήσεις
import { defineConfig } from 'vitest/config';
export default defineConfig({
test: {
coverage: {
provider: 'v8',
reporter: ['text', 'html'],
thresholds: {
lines: 80,
functions: 80,
},
},
},
});Ο provider v8 είναι η προεπιλογή· το text reporter τυπώνει πίνακα στο τερματικό και το html βγάζει πλοηγήσιμη αναφορά. Τα thresholds κάνουν το CI να αποτυγχάνει κάτω από το όριο — βάλτε 80 ως αρχή, ανεβάστε σταδιακά. Και ο αστερίσκος: το coverage μετρά εκτέλεση, όχι απόδειξη — 100% με αδύναμα assertions δεν αποδεικνύει τίποτα, και το line coverage κρύβει ακάλυπτα branches (γι' αυτό υπάρχει και το branches threshold). Δείτε το Vitest coverage.
console.log(typeof describe);Τι τυπώνει αυτή η γραμμή όταν τρέχει μέσα σε αρχείο Vitest;
vitest (watch)· στο CI πάντα npx vitest run — ρητά μία εκτέλεση, ανεξάρτητα από το περιβάλλον.toBe για primitives (αναφορά), toEqual για δομή· το μήνυμα Object.is equality σημαίνει λάθος matcher..resolves/.rejects· το mock μπαίνει στο boundary (global fetch), ποτέ στη συνάρτηση υπό δοκιμή.@vitest/coverage-v8 + --coverage· κατώφλια στο config· μετρά εκτέλεση, όχι απόδειξη.