Component testing — Vitest va React Testing Library bilan foydalanuvchi harakatlarini test qilish
React ilovalarida avtomatlashtirilgan komponent testlari, Vitest va React Testing Library (RTL) falsafasi, screen so'rovlari va @testing-library/user-event orqali foydalanuvchi harakatlarini sinash.
86-dars
Component testing — Vitest va React Testing Library bilan foydalanuvchi harakatlarini test qilish
Har safar dasturga yangi funksiya qo'shganda yoki kodni tozalaganda (refactoring), ilovaning eski ishlagan qismlari buzilib qolmaganiga ishonch hosil qilish uchun avtomatlashtirilgan testlar yoziladi. Zamonaviy React ekotizimida komponentlarni sinovdan o'tkazish bo'yicha eng ilg'or tandem bu — Vitest va React Testing Library (RTL) hisoblanadi.
Asosiy tushunchalar va Falsafa
1. React Testing Library (RTL) Falsafasi
RTL Oltin qoidasi: "The more your tests resemble the way your software is used, the more confidence they can give you." (Testlaringiz dasturiy ta'minotdan foydalanish tarziga qanchalik yaqin bo'lsa, ular sizga shunchalik katta ishonch beradi). — Kent C. Dodds
RTL'ning eng katta ustunligi — u komponentning ichki tuzilishiga (implementation details) aralashmaydi.
- Siz state nomini
countdeb atadingizmi yokivalmi; - Funksiyangiz qanday nomlangan;
- Komponent qaysi hook'larni ishlatyapti — RTL uchun mutlaqo ahamiyatsiz.
RTL testni xuddi haqiqiy foydalanuvchi kabi o'tkazadi: ekrandagi tugmani qidirib topadi, uni bosadi va matn o'zgarganini tekshiradi.
2. Vitest nima?
Vitest — bu Vite asosida ishlaydigan zamonaviy va o'ta tezkor test muharriri (test runner). U Jest bilan 100% deyarli bir xil sintaksisga ega (describe, test, expect), ammo Vite konfiguratsiyasini to'g'ridan-to'g'ri o'qiy olgani sababli undan bir necha barobar tezroq ishga tushadi.
Amaliy misol: Komponent va uning testi
1. Komponent: Counter.tsx
import { useState } from 'react';
export function Counter() {
const [count, setCount] = useState<number>(0);
return (
<div style={{ padding: '16px', border: '1px solid #cbd5e1', borderRadius: '8px' }}>
<h3>Hisoblagich</h3>
<p data-testid="count-display">Hisob: {count}</p>
<div style={{ display: 'flex', gap: '8px' }}>
<button onClick={() => setCount((c) => c + 1)}>
Oshirish
</button>
<button onClick={() => setCount(0)}>
Tozalash
</button>
</div>
</div>
);
}
2. Test fayli: Counter.test.tsx
import { render, screen } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { describe, test, expect } from 'vitest';
import { Counter } from './Counter';
describe('Counter Komponenti', () => {
test("Boshlang'ich qiymat 0 ekanligini to'g'ri ko'rsatadi", () => {
// 1. Komponentni virtual DOM'ga render qilamiz
render(<Counter />);
// 2. Foydalanuvchi ko'radigan matnni qidiramiz
const heading = screen.getByRole('heading', { name: /hisoblagich/i });
const countText = screen.getByText('Hisob: 0');
// 3. Tekshiruv (Assertion)
expect(heading).toBeInTheDocument();
expect(countText).toBeInTheDocument();
});
test("Oshirish tugmasi bosilganda hisob 1 ga oshadi", async () => {
// userEvent sessiyasini sozlaymiz
const user = userEvent.setup();
render(<Counter />);
// Tugmani foydalanuvchilar va screen reader ko'radigan roli bo'yicha topamiz
const incrementButton = screen.getByRole('button', { name: /oshirish/i });
// Haqiqiy inson harakatini simulyatsiya qilamiz (bosish)
await user.click(incrementButton);
// Ekranda 'Hisob: 1' matni paydo bo'lganini tasdiqlaymiz
expect(screen.getByText('Hisob: 1')).toBeInTheDocument();
});
test("Tozalash tugmasi bosilganda hisob 0 ga qaytadi", async () => {
const user = userEvent.setup();
render(<Counter />);
const incrementButton = screen.getByRole('button', { name: /oshirish/i });
const resetButton = screen.getByRole('button', { name: /tozalash/i });
// Ikki marta oshiramiz
await user.click(incrementButton);
await user.click(incrementButton);
expect(screen.getByText('Hisob: 2')).toBeInTheDocument();
// Tozalashni bosamiz
await user.click(resetButton);
expect(screen.getByText('Hisob: 0')).toBeInTheDocument();
});
});
Elementlarni qidirish qoidalari (Query Priority)
RTL sizga elementlarni qidirish uchun turli metodlarni taqdim etadi. Ularni tanlashda quyidagi ustuvorlik tartibiga rioya qilish shart:
getByRole(Mutlaq tavsiya): Eng yaxshi usul. Elementning brauzer va imkoniyati cheklanganlar (Accessibility / ARIA) uchun rolini tekshiradi (button,heading,textbox,checkbox).screen.getByRole('button', { name: /saqlash/i });getByLabelText: Formalar uchun ajoyib (<label for="...">ga ulangan inputlar).getByPlaceholderText/getByText: Matnli elementlar va paragraflar uchun.getByTestId(Oxirgi chora): Faqat va faqat boshqa hech qanday tabiiy usul bilan elementni topib bo'lmagandagina ishlatiladi.
getBy..., queryBy... va findBy... farqi
| Metod prefiksi | Element topilmasa nima qiladi? | Asinxronmi? | Qachon ishlatiladi? |
|---|---|---|---|
getBy... |
Darhol xato (throw error) beradi |
Yo'q | Element ekranda bo'lishi shart bo'lganda |
queryBy... |
null qaytaradi (xato bermaydi) |
Yo'q | Element ekranda yo'qligini tekshirganda (expect(...).not.toBeInTheDocument()) |
findBy... |
1 soniya kutadi, topilmasa xato beradi | HA (Promise) |
Ma'lumot serverdan kelib keyinroq chiqadigan holatlarda (await screen.findByRole(...)) |
Nega fireEvent emas, aynan userEvent?
[!TIP] Doimo
@testing-library/user-eventkutubxonasidan foydalaning!
fireEvent.click(btn): Brauzerda shunchaki bitta sun'iyclickhodisasini chaqiradi.userEvent.click(btn): Haqiqiy inson harakatini to'liq simulyatsiya qiladi — sichqonchani element ustiga olib boradi (hover), tugmaga fokus beradi (focus), bosadi (pointerdown, mousedown), va nihoyat chertadi (click).
Real hayotiy analogiya: Yangi avtomobilni sinash
Tasavvur qiling, zavod yangi avtomobil ishlab chiqardi:
- Ichki tuzilmani test qilish (Eski xato yondashuv): Muhandis kapotni ochib, motor simining rangi ko'kmi-qizilmi deb tekshiradi. Ertaga sim rangini o'zgartirsangiz, avtomobil zo'r yursa ham test "buzuq" deb baqiradi.
- RTL yondashuvi (Foydalanuvchi sinovi): Haydovchi eshikni ochib rulga o'tiradi, kalitni buradi, gaz pedalini bosadi va mashina oldinga yurganini ko'radi. Motor ichidagi sim qaysi rangdaligi haydovchini umuman qiziqtirmaydi!
Xulosa
Vitest va React Testing Library bilan test yozish — nafaqat dasturingizning xatolardan holi bo'lishini ta'minlaydi, balki kodingizning barcha foydalanuvchilar uchun qulay va ochiq (accessible) bo'lishiga majbur qiladi. Foydalanuvchi ko'radigan elementlar orqali test yozing, shunda kodingizni qanchalik o'zgartirmang, testlaringiz ishonchli himoyachi bo'lib qolaveradi!