Kurs NestJS · Moduł 7: Testowanie
Test Automation - automatyczne kontrole jakości
W tej lekcji6
Masz komplet testów: jednostkowe, integracyjne, E2E, z atrapami i raportem pokrycia. Ale uruchamiasz je ręcznie. Wystarczy jeden pośpieszny wieczór, żeby ktoś wypchnął zmianę bez sprawdzenia - i cały ten arsenał okaże się bezużyteczny.
Legion nie polega na pamięci wartowników. Ustawia warty stałe: kontrola odbywa się sama, o wyznaczonej porze, niezależnie od tego, kto akurat pełni służbę. Tym właśnie jest automatyzacja testów - przeniesieniem odpowiedzialności z człowieka na maszynę.
Warta stała - testy przy każdej zmianie
Najprostsza warta uruchamia testy przy każdym wypchnięciu kodu:
# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci
- run: npm run test
- run: npm run test:e2eCzyta się to jak rozkaz dzienny. on: [push, pull_request] wyznacza moment kontroli. npm ci instaluje zależności ściśle według package-lock.json - w przeciwieństwie do npm install niczego nie aktualizuje, więc warta sprawdza dokładnie te wersje, które zapisałeś. Potem lecą testy.
Kluczowe jest to, czego w tym pliku nie widać: każde polecenie musi zwrócić zero. Jeśli npm run test zakończy się błędem, warta podnosi alarm i zmiana nie wejdzie do gałęzi głównej. Cała moc automatyzacji sprowadza się do tego jednego kodu wyjścia.
Zielona warta, która kłamie
I tu dochodzimy do najważniejszej rzeczy w tej lekcji. Zautomatyzowany test jest wart tyle, ile jego rzetelność - a test asynchroniczny potrafi przechodzić, nie sprawdzając niczego.
Spójrz na te dwie wersje:
// ŹLE - test kończy się, zanim obietnica się rozstrzygnie
it('znajduje legionistę', () => {
service.findById(1);
});
// DOBRZE - test czeka na wynik
it('znajduje legionistę', async () => {
const legionary = await service.findById(1);
expect(legionary.name).toBe('Marek');
});W pierwszej wersji funkcja testowa kończy się natychmiast po wywołaniu metody. Jest uznaje test za zaliczony, bo nic nie rzuciło wyjątku w tym momencie - a metoda dopiero zaczyna pracę. Gdyby zwróciła złe dane albo padła sekundę później, nikt się nie dowie.
Reguła jest krótka i bezwyjątkowa: test dotykający kodu asynchronicznego musi być async, a każde wywołanie zwracające obietnicę - poprzedzone await. Zapomniany await to najczęstsza przyczyna zielonych pipeline'ów nad zepsutym kodem.
Sprawdzanie wyjątków - wariant synchroniczny
Testujemy nie tylko powodzenia. Gdy metoda ma rzucić wyjątek, potrzebujemy asercji, która to potwierdzi:
it('odrzuca ujemny żołd', () => {
expect(() => service.validatePay(-100)).toThrow();
});Zwróć uwagę na kształt argumentu: do expect przekazujemy funkcję, a nie wynik jej wywołania. Gdybyśmy napisali expect(service.validatePay(-100)), wyjątek poleciałby natychmiast, poza kontrolą Jest, i test padłby zamiast przejść. Owinięcie w () => ... daje Jest możliwość wywołania metody samemu i przechwycenia tego, co z niej wypadnie.
toThrow() bez argumentu akceptuje dowolny wyjątek. Możesz zawęzić: toThrow(BadRequestException) sprawdzi typ, a toThrow('Żołd nie może być ujemny') - treść komunikatu.
Sprawdzanie wyjątków - wariant asynchroniczny
Metoda asynchroniczna nie rzuca wyjątku - zwraca odrzuconą obietnicę. Dlatego toThrow() z poprzedniej sekcji tu nie zadziała; potrzebna jest przystawka rejects:
it('rzuca NotFoundException dla nieznanego id', async () => {
jest.spyOn(repo, 'findOne').mockResolvedValue(null);
await expect(service.findById(999)).rejects.toThrow(NotFoundException);
});Prześledźmy tę asercję po kolei, bo składa się z czterech elementów w ustalonej kolejności. await expect( otwiera oczekiwanie - i to await na początku jest tym, o czym zapomina się najczęściej; bez niego test skończy się przed rozstrzygnięciem obietnicy i znów przejdzie fałszywie. Dalej service.findById(999) - tutaj nie owijamy wywołania w funkcję, bo obietnica jest zwykłą wartością, którą można przekazać. Potem .rejects przełącza asercję na odrzucenie, a .toThrow(NotFoundException) sprawdza typ.
Kolejność pracy przy takim teście jest zawsze ta sama: ustaw atrapę tak, by wywołała błąd, wywołaj metodę, użyj rejects.toThrow(), a na końcu doprecyzuj typ i komunikat. Tutaj atrapa repozytorium zwraca null, co zmusza serwis do rzucenia NotFoundException - sprawdzamy więc obsługę błędu, nie sam błąd bazy.
Bramka lokalna - zanim kod wyjdzie z obozu
Warta w CI wyłapuje wszystko, ale odpowiada po kilku minutach. Szybszą kontrolę stawiamy na własnej maszynie:
# .husky/pre-commit
npm run lint
npm run test -- --onlyChangedHusky podpina ten skrypt pod git commit - gdy któreś polecenie zwróci błąd, commit się nie wykona. Flaga --onlyChanged każe Jest uruchomić wyłącznie testy związane ze zmienionymi plikami, więc bramka trwa sekundy, a nie minuty.
Zauważ podział ról: hak lokalny jest szybki i wybiórczy, warta w CI - wolna i kompletna. Hak ma łapać oczywiste potknięcia, zanim zajmą czyjś czas; nie zastępuje pełnego przebiegu. I to polecam: nie wsadzaj do haka wszystkich testów, bo pierwsze, czego nauczy się zespół, to --no-verify.
Podsumowanie
Warty rozstawione, kontrola dzieje się sama:
- automatyzacja przenosi uruchamianie testów z człowieka na maszynę - decyduje kod wyjścia polecenia,
on: [push, pull_request]wyznacza moment kontroli,npm ciinstaluje dokładnie wersje zpackage-lock.json,- test dotykający kodu asynchronicznego musi być
asynci używaćawait- bez tego przechodzi, nie sprawdzając niczego, - wyjątek synchroniczny:
expect(() => metoda()).toThrow()- doexpectidzie funkcja, nie jej wynik, toThrow()przyjmuje typ wyjątku lub fragment komunikatu, gdy chcesz zawęzić sprawdzenie,- odrzucona obietnica:
await expect(metoda()).rejects.toThrow(NotFoundException)- tu przekazujemy samą obietnicę, bez owijania w funkcję, - kolejność: ustaw atrapę na błąd, wywołaj metodę,
rejects.toThrow(), zweryfikuj typ i komunikat, - hak
pre-commitz--onlyChangeddaje szybką bramkę lokalną; pełny przebieg zostaw dla CI.
W następnej lekcji zmierzysz się z projektem - kompleksowym otestowaniem systemu zarządzania flotą. A na razie zapamiętaj: warta stała jest warta tyle, ile rzetelność testów, które uruchamia - a test bez await melduje spokój, choć nikt nie sprawdzał bram.
Kod do tej lekcji: src/test-automation.ts
// Test Automation - Automatyczne Kontrole Jakosci
// 1. Konfiguracja Jest w package.json
const jestConfig = {
moduleFileExtensions: ['js', 'json', 'ts'],
rootDir: 'src',
testRegex: '.*\\.spec\\.ts$',
transform: { '^.+\\.(t|j)s$': 'ts-jest' },
collectCoverageFrom: ['**/*.(t|j)s'],
coverageDirectory: '../coverage',
testEnvironment: 'node',
coverageThreshold: {
global: {
branches: 80,
functions: 80,
lines: 80,
statements: 80,
},
},
};
// 2. Pre-commit hooks z Husky
const huskyConfig = {
hooks: {
'pre-commit': 'npm run lint && npm run test',
'pre-push': 'npm run test:cov && npm run test:e2e',
},
};
// 3. GitHub Actions workflow
const ciYaml = `
name: Roman Empire CI
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [18.x, 20.x]
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: \${{ matrix.node-version }}
- run: npm ci
- run: npm run lint
- run: npm run test:cov
- run: npm run test:e2e
`;
// 4. Test Reporter
class TestReporter {
private results: Array<{
suite: string;
test: string;
passed: boolean;
duration: number;
}> = [];
addResult(
suite: string, test: string,
passed: boolean, duration: number
) {
this.results.push({ suite, test, passed, duration });
}
generateReport() {
const total = this.results.length;
const passed = this.results.filter(r => r.passed).length;
const failed = total - passed;
const avgDuration = this.results.reduce(
(sum, r) => sum + r.duration, 0
) / total;
return {
summary: {
total,
passed,
failed,
passRate: `${((passed / total) * 100).toFixed(1)}%`,
avgDuration: `${avgDuration.toFixed(2)}ms`,
},
failures: this.results
.filter(r => !r.passed)
.map(r => `${r.suite} > ${r.test}`),
};
}
}
// 5. Przyklad uzycia
const reporter = new TestReporter();
reporter.addResult('LegionService', 'findAll', true, 5.2);
reporter.addResult('LegionService', 'create', true, 8.1);
reporter.addResult('ProvinceCtrl', 'GET /provinces', true, 12.3);
reporter.addResult('AuthGuard', 'block unauthorized', true, 3.7);
console.log(JSON.stringify(reporter.generateReport(), null, 2));
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Aby przetestować asynchroniczną metodę w Jest, test powinien:
2. Aby sprawdzić czy metoda rzuca wyjątek, używamy:
Zadania praktyczne w grze
- Edytor kodu
Przetestuj scenariusz gdy serwis rzuca NotFoundException
- Układanie w pionie
Uporządkuj kroki testowania asynchronicznego wyjątku:
- Klikanie w kolejności
Ułóż asercję testującą rejected Promise: