Seriya: React Basics Dars 86

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 count deb atadingizmi yoki valmi;
  • 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:

  1. 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 });
    
  2. getByLabelText: Formalar uchun ajoyib (<label for="..."> ga ulangan inputlar).
  3. getByPlaceholderText / getByText: Matnli elementlar va paragraflar uchun.
  4. 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-event kutubxonasidan foydalaning!

  • fireEvent.click(btn): Brauzerda shunchaki bitta sun'iy click hodisasini 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!