Əsas məzmuna keç
FrontDepth, Ana səhifə

Testləşdirmə

UI-ı istifadəçinin işlətdiyi kimi test etmək

Komponentləri insanların işlətdiyi kimi test etmək: Testing Library-nin əsas prinsipi və query prioriteti, getBy, queryBy və findBy, fireEvent əvəzinə user-event, jest-dom ilə istifadəçinin hiss etdiyini yoxlamaq, form nümunəsi, jsdom-un göstərə bilmədikləri və səhv səbəbdən düşən testlər.

JuniorMiddleSeniorYenilənib: 16 noyabr 2026

Oxu səviyyəsi

Seçilmiş səviyyəyə qədər olan bölmələr göstərilir.

Bu mövzu Junior səviyyəsindən başlayır.

JuniorKonsepsiya

İstifadəçinin gördüyünü və etdiyini test et

Testing Library müəllifi Kent C. Dodds-un bir cümləsi üzərində qurulub: "Testlər proqramın necə istifadə olunduğuna nə qədər çox bənzəsə, sənə bir o qədər çox əminlik verə bilər." Komponentin iki növ istifadəçisi var: onu görüb klikləyən insan və onu props ilə render edən developer. UI testi komponentlə məhz onlar kimi davranmalıdır: elementləri ekranda göstərdiklərinə görə tapmalı, insan kimi qarşılıqlı əlaqəyə girməli və sonda ekranda nə olduğunu yoxlamalıdır.

Qalan hər şeyi (state dəyişənlərini, hook-ları, komponent instance-larını, CSS class adlarını) Kent C. Dodds implementasiya detalları adlandırır: "kodunun istifadəçilərinin adətən işlətmədiyi, görmədiyi, hətta varlığından xəbər tutmadığı şeylər". Onlara söykənən testlər hər iki istiqamətdə yanılır. Refaktorinq zamanı, məsələn, useState useReducer-ə çevriləndə, istifadəçi üçün heç nə dəyişməsə də düşürlər. Ekrandakı düymə artıq heç nə etməyəndə isə keçməyə davam edirlər.

İlk komponent testi

React üçün geniş yayılmış alət dəsti belədir: Vitest testləri simulyasiya olunmuş brauzer mühitində (jsdom və ya happy-dom) işə salır, React Testing Library komponenti render edir, @testing-library/user-event istifadəçinin rolunu oynayır, @testing-library/jest-dom isə DOM üçün matcher-lər əlavə edir.

TSX
import { render, screen } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { expect, test } from "vitest";
import { QuantityPicker } from "./QuantityPicker";

test("increases the quantity", async () => {
  const user = userEvent.setup();
  render(<QuantityPicker initial={1} />);

  await user.click(screen.getByRole("button", { name: "Increase quantity" }));

  expect(screen.getByText("Quantity: 2")).toBeInTheDocument();
});
  • render komponenti document.body-yə əlavə etdiyi div-in içinə mount edir.
  • screen document.body-yə bağlanmış bütün query-ləri saxlayır. Testing Library render-in qaytardığı query-lər əvəzinə ondan istifadəni tövsiyə edir.
  • Test əl ilə yoxlama kimi oxunur: düyməni rolu və adı ilə tap, kliklə, yeni mətni axtar. Test sayın useState-də, reducer-də, yoxsa store-da saxlandığını bilmir.

Kent C. Dodds-un təsnifatında bir komponentin belə testi unit testdir. Eyni alətlər şəbəkəsi mock edilmiş bütöv səhifələri də render edir, o isə bunları sayır. Hər iki halda test real brauzerdə yox, simulyasiya olunmuş brauzerdə işləyir.

Asanlıqla gözdən qaçan quraşdırma

Hər testdən sonra cleanup render-in mount etdiyini unmount edir. React Testing Library onu yalnız test runner qlobal afterEach təqdim edəndə avtomatik qeydiyyatdan keçirir. Vitest isə default olaraq bunu etmir, ona görə ya globals: true təyin et, ya da setup faylında afterEach içində cleanup() çağır. Həmin setup faylı @testing-library/jest-dom/vitest-i də import edir: o, Vitest-in expect-inə toBeInTheDocument kimi matcher-lər əlavə edir. Cleanup olmasa, əvvəlki testin DOM-u sənəddə qalır və növbəti test hər şeydən iki dənə tapır.

JuniorKonsepsiya

Elementləri tapmaq: query-lərin prioriteti

Testing Library-nin query-ləri elementləri insanlar kimi tapır. Onun sənədləri bu sıranı tövsiyə edir:

  1. Hamı üçün əlçatan query-lər. getByRole ("demək olar ki, hər şey üçün əsas seçimin"), form sahələri üçün getByLabelText, sahənin bundan yaxşı heç nəyi olmayanda getByPlaceholderText, interaktiv olmayan məzmun üçün getByText, doldurulmuş sahələr üçün getByDisplayValue.
  2. Semantik query-lər. getByAltText və getByTitle. Sənədlər xəbərdarlıq edir ki, title-ı screen reader-lər ardıcıl oxumur, görən istifadəçilər üçün isə o, default olaraq görünmür.
  3. Test ID-lər. getByTestId, yalnız başqa heç nə uyğun gəlməyəndə: istifadəçilər data-testid-i nə görür, nə də eşidir.
TSX
screen.getByRole("heading", { name: "Order summary" });
screen.getByRole("button", { name: /place order/i });
screen.getByRole("checkbox", { name: "Gift wrap" });
screen.getByLabelText("Promo code");
screen.getByText("Free delivery on orders over $50");

Role query-lər niyə həm də əlçatanlığı yoxlayır

getByRole(role, { name }) accessibility tree-də, yəni screen reader-in istifadə etdiyi eyni məlumatda axtarır. Rol elementin özündən gəlir (<button> heç bir role atributu olmadan düymədir), ad isə onun : düymənin mətni, sahənin label-i, aria-label. getByRole("button", { name: "Close" }) yalnız ikondan ibarət bağlama düyməsini tapa bilmirsə, screen reader istifadəçisi də adsız "button" eşidir, deməli, test real bug tapıb. Role query düşəndə xəta mesajı tapdığı əlçatan rolları və adları sadalayır; problemi görmək üçün çox vaxt bu kifayətdir. Brauzerlərin adı necə hesabladığı ARIA və fokus mövzusunda izah olunur.

Bilməli olduğun bir istisna: <input type="password">-in implicit rolu yoxdur, ona görə onu getByLabelText ilə tap.

Mətnə görə axtarış

Sətir kənar boşluqlar silinib daxili boşluqlar birləşdirildikdən sonra bütün mətnlə, böyük-kiçik hərfə həssas şəkildə müqayisə olunur. Regular expression isə mətnin bir hissəsinə uyğun gəlir: "Place order" "Place order now"-a çevriləndə də /place order/i onu tapır. { exact: false } böyük-kiçik hərfə həssas olmayan alt sətir axtarışı verir, amma sənədlər qeyri-dəqiq axtarış üçün regex-ə üstünlük verir. getByText yalnız elementin öz mətn node-larını müqayisə edir, ona görə <p>Total: <strong>$40</strong></p> "Total: $40"-a uyğun gəlmir. Bunun əvəzinə rolu və adı olan elementi tap və ya paraqrafın mətnini toHaveTextContent ilə yoxla.

Səhifənin bir hissəsində axtarmaq üçün query-ləri within ilə məhdudlaşdır:

TSX
const cart = screen.getByRole("list", { name: "Cart" });
expect(within(cart).getAllByRole("listitem")).toHaveLength(2);
JuniorKonsepsiya

getBy, queryBy və findBy

Hər query üç formada olur və prefiks element olmayanda nə baş verəcəyini müəyyən edir:

QueryUyğun element yoxdurBir elementBirdən çoxGözləyir
getBy...xəta atıronu qaytarırxəta atıryox
queryBy...null qaytarıronu qaytarırxəta atıryox
findBy...reject oluronunla resolve olurreject olurbəli, default 1000 ms

Siyahılar üçün hər birinin All variantı var: getAllBy... heç nə tapmayanda xəta atır, queryAllBy... [] qaytarır, findAllBy... isə ən azı bir uyğun element gözləyir.

Hansını nə vaxt işlətməli

  • Default olaraq getBy. Element olmayan sətirdə düşür və mesajda cari DOM-u çap edir.
  • queryBy yalnız nəyinsə olmadığını sübut etmək üçün:
TSX
expect(screen.queryByRole("alert")).not.toBeInTheDocument();

Burada getByRole("alert") expect işə düşməmiş xəta atardı. Əks səhv, yəni mütləq olmalı olan element üçün queryBy, işləyir, amma zəif mesajla düşür. Kent C. Dodds-un məsləhəti belədir: query* variantlarını yalnız elementin tapılmadığını yoxlamaq üçün işlət.

  • Sonradan görünən elementlər üçün findBy: sorğudan, taymerdən və ya effektdən sonra. O, promise qaytarır, ona görə mütləq await olunmalıdır:
TSX
await user.click(screen.getByRole("button", { name: "Load more" }));
expect(await screen.findAllByRole("article")).toHaveLength(20);

findBy getBy ilə waitFor-un birləşməsidir: query uğurlu olana və ya timeout bitənə qədər təkrar cəhd edir. Gözləməni async və flaky testlər mövzusu ətraflı izah edir.

"Found multiple elements"

getBy, queryBy və findBy birdən çox element uyğun gələndə xəta atır. Bu, faydalı xüsusiyyətdir: beş "Remove" düyməsi olan səhifədə "Remove"-a klikləyən test hansını nəzərdə tutduğunu deməlidir. Query-ni adla ({ name: "Remove Rain jacket" }) daralt və ya within ilə məhdudlaşdır. Xətanı susdurmaq üçün getAllByRole("button")[0]-a əl atma: test onda təsadüfən birinci gələn elementə klikləyir, sıra dəyişəndə isə başqasına.

Təkrarlanan element cari testin heç vaxt render etmədiyi markup-dan gəlirsə, əvvəlki testin DOM-u hələ də sənəddədir: cleanup işləmir.

MiddleFramework

fireEvent əvəzinə user-event

Testing Library-də qarşılıqlı əlaqənin iki yolu var. fireEvent bir DOM event-i göndərir: fireEvent.click(button) click event-i yaradır, başqa heç nə. user-event sənədləri fireEvent-i brauzerin aşağı səviyyəli dispatchEvent API-si üzərində yüngül bir örtük adlandırır, user-event isə konkret event-i yox, istifadəçinin qarşılıqlı əlaqəsini təsvir etməyə imkan verir. Real klikdə kursor elementin üzərinə gəlir, siçanın düyməsi basılıb buraxılır və click-dən əvvəl element fokus alır. Yazı yazanda sahə fokuslanır, sonra dəyər və seçim (selection) dəyişdikcə hər simvol üçün klaviatura və input event-ləri göndərilir. user-event brauzerin icazə vermədiyini də etmir: disabled sahəyə yazmır və pointer-events: none olan elementə klikləmir.

TSX
test("adds a tag on Enter", async () => {
  const user = userEvent.setup();
  render(<TagInput />);

  const input = screen.getByRole("textbox", { name: "New tag" });
  await user.type(input, "urgent{Enter}");

  expect(screen.getByRole("listitem")).toHaveTextContent("urgent");
  expect(input).toHaveValue("");
});

Eyni test fireEvent ilə fireEvent.change(input, { target: { value: "urgent" } }), ardınca isə fireEvent.keyDown(input, { key: "Enter" }) tələb edir və bu, testi komponentin təsadüfən dinlədiyi event-ə bağlayır. user-event form sahəsində Enter-in etdiyini də edir: formun submit düyməsinə klikləyir və ya yeganə sahəsi bu olan formu göndərir. Ona görə komponent onKeyDown handler-indən <form onSubmit>-ə keçsə, user-event testi keçməyə davam edir, fireEvent.keyDown variantı isə istifadəçi heç bir dəyişiklik görməsə də düşür. Əks istiqamətdə də belədir: fireEvent.change sahəni heç vaxt fokuslamır və fokusdan çıxarmır, ona görə "sahə fokusu itirəndə yoxla" qaydası heç vaxt işə düşmür; await user.tab() isə onu işə salır.

İstifadə qaydası

  • userEvent.setup()-ı testin əvvəlində, render-dən əvvəl çağır. Sənədlər user-event-i beforeEach və digər hook-larda çağırmağı və orada render etməyi məsləhət görmür.
  • Hər metod promise qaytarır. Hər çağırışı await et, yoxsa növbəti sətir qarşılıqlı əlaqə bitməmiş işləyir.
  • Ən çox lazım olacaq metodlar: click, dblClick, hover, type (əvvəlcə sahəyə klikləyir), keyboard("{Shift>}{Tab}{/Shift}"), tab(), clear, <select> üçün selectOptions və fayl input-u üçün upload.

fireEvent user-event-in modelləşdirmədiyi event-lər, məsələn scroll üçün, və ya kodunun həqiqətən asılı olduğu tək bir aşağı səviyyəli event üçün yenə də düzgün alətdir. user-event-in hələ təsvir edə bilmədiyi qarşılıqlı əlaqələr üçün onun sənədləri proqramının asılı olduğu konkret event-ləri fireEvent ilə göndərməyi təklif edir. Bunun qiyməti odur ki, test onda real qarşılıqlı əlaqənin hansı event-ləri göndərdiyi barədə sənin fərziyyələrini özündə saxlayır.

MiddleKonsepsiya

İstifadəçinin hiss etdiyini yoxla

Testin sonu istifadəçinin aldığı nəticəni yoxlamalıdır: ekrandakı mətni, sahənin dəyərini, disabled düyməni, fokusun harada olduğunu. jest-dom məhz bunun üçün matcher-lər verir:

  • toBeInTheDocument(): element sənədə qoşulub.
  • toHaveTextContent(text): sətirlə bu, alt sətir axtarışıdır, ona görə toHaveTextContent("$4") "Total: $40" üçün keçir. Bütün mətni yoxlamaq üçün /^Total: \$40$/ kimi regex işlət.
  • toBeVisible(): element sənəddədir; nə onun özündə, nə də heç bir üst elementində (ancestor) display: none, visibility: hidden və ya collapse, opacity: 0, ya da hidden atributu var; bağlı <details> isə öz məzmununu gizlədir.
  • toBeDisabled() və toBeEnabled(): disabled atributu, disabled <fieldset>-dən gələn də daxil olmaqla. aria-disabled-ı nəzərə almırlar.
  • toHaveValue(), toHaveDisplayValue() və toBeChecked(): formun vəziyyəti.
  • toHaveFocus(): klaviatura fokusunun harada olduğu.
  • toHaveAccessibleName() və toHaveAccessibleDescription(): köməkçi texnologiyanın kontrol üçün səsləndirdiyi məlumat.
  • toBeInvalid(): aria-invalid="true" və ya brauzerin öz constraint validation yoxlamasının uğursuz olması.

Bu matcher-lər expect(button.disabled).toBe(true)-dan daha yaxşı düşür də: mesaj quru "expected false to be true" əvəzinə elementi göstərir.

Nəyi yoxlamamalı

  • State və daxili detallar: useState-in içindəki dəyər, reducer-in state-i, komponentin neçə dəfə render olunduğu, hansı hook-un çağırıldığı.
  • Uşaq komponentlərə ötürülən props, eləcə də test aldığı props-u yoxlaya bilsin deyə stub ilə əvəzlənmiş uşaq komponent.
  • Class adları və markup strukturu, əgər istifadəçinin fərqi hiss etməsinin yeganə yolu onlar deyilsə.

React Testing Library-də props-u yeniləmək üçün rerender(<Price amount={20} />) var, amma onun sənədləri bunun əvəzinə props-u yeniləyən komponenti test etməyi məsləhət görür, çünki dəyər real həyatda məhz belə dəyişir.

Callback-lər çıxışdır

Callback prop komponentin valideynlə müqaviləsinin bir hissəsidir, ona görə onu funksiya ilə yoxlamaq daxili detalı yox, davranışı test edir:

TSX
const onInvite = vi.fn();
render(<InviteForm onInvite={onInvite} />);
await user.type(screen.getByRole("textbox", { name: "Email" }), "ana@example.com");
await user.click(screen.getByRole("button", { name: "Send invite" }));
expect(onInvite).toHaveBeenCalledWith("ana@example.com");

Hər assertion-dan əvvəl özünə faydalı bir sual ver: istifadəçi və ya valideyn komponent bunu hiss edə bilərmi? Dəyişikliyi görməyin yeganə yolu komponentin daxilini oxumaqdırsa, test implementasiya detalını yoxlayır.

MiddleNümunə

Nümunə: validasiya mesajı olan form

Dəvət formunda bir email sahəsi və "Send invite" düyməsi var. Yanlış ünvan sahənin altında xəta göstərir, düzgün ünvan isə onInvite-ı çağırır.

TSX
export function InviteForm({ onInvite }: { onInvite: (email: string) => void }) {
  const [error, setError] = useState("");

  function handleSubmit(event: FormEvent<HTMLFormElement>) {
    event.preventDefault();
    const email = String(new FormData(event.currentTarget).get("email")).trim();
    if (!email.includes("@")) {
      setError("Enter a valid email address");
      return;
    }
    setError("");
    onInvite(email);
  }

  return (
    <form onSubmit={handleSubmit} noValidate>
      <label htmlFor="invite-email">Email</label>
      <input id="invite-email" name="email" type="email" aria-invalid={error !== ""}
        aria-describedby={error ? "invite-error" : undefined} />
      {error && <p id="invite-error">{error}</p>}
      <button type="submit">Send invite</button>
    </form>
  );
}
TSX
test("rejects an address without @", async () => {
  const user = userEvent.setup();
  const onInvite = vi.fn();
  render(<InviteForm onInvite={onInvite} />);

  const email = screen.getByRole("textbox", { name: "Email" });
  await user.type(email, "ana.example.com");
  await user.click(screen.getByRole("button", { name: "Send invite" }));

  expect(email).toHaveAttribute("aria-invalid", "true");
  expect(email).toHaveAccessibleDescription("Enter a valid email address");
  expect(onInvite).not.toHaveBeenCalled();
});

İkinci test ana@example.com yazır, formu göndərir və expect(onInvite).toHaveBeenCalledWith("ana@example.com")-u, eləcə də queryByText("Enter a valid email address")-in sənəddə olmadığını yoxlayır.

Bu testlərin düzgün etdikləri:

  • Sahə label-i ilə, düymə isə adı ilə tapılır, ona görə çatışmayan <label> və ya adsız düymə testi uğursuz edir.
  • toHaveAccessibleDescription mesajın sahəyə aria-describedby ilə bağlandığını yoxlayır, yəni screen reader onu sahə ilə birlikdə səsləndirir. getByText("Enter a valid email address") isə mesaj səhifədə sahə ilə əlaqəsiz dursa belə keçərdi.
  • aria-invalid birbaşa yoxlanılır: köməkçi texnologiyanın bildirdiyi vəziyyət budur. toBeInvalid() yalnız brauzerin öz validasiyası uğursuz olanda da keçərdi, çünki o, checkValidity()-ni də nəzərə alır.
  • Hər iki yol əhatə olunub, düzgün yol isə xətanın görünmədiyini də yoxlayır. Daha bir test yazmağa dəyər: xətadan sonra ünvanı düzəlt və mesajın yox olduğunu yoxla.
  • noValidate brauzerin daxili validasiyasını söndürür, ona görə istifadəçi formun öz mesajını, yəni testlərin yoxladığı mesajı görür.

Form sahə fokusu itirəndə yoxlasaydı, test formu göndərmək əvəzinə await user.tab() ilə sahədən çıxardı.

SeniorVeb platforma

jsdom-un sənə deyə bilmədikləri

Vitest-in jsdom və happy-dom mühitləri DOM-u və bir çox brauzer API-sini Node-da həyata keçirir. Onlar sürətlidir və komponent davranışının çoxunu yoxlamağa yetir, amma brauzer deyillər. jsdom-un README-si bunu açıq deyir: o, heç bir layout və ya rendering etmir.

  • Layout yoxdur. getBoundingClientRect(), offsetWidth və offsetTop sıfır qaytarır, heç nə scroll olunmur, window.scrollTo isə yalnız "not implemented" bildirir. Elementləri ölçən, tooltip-in yerini hesablayan və ya siyahını virtuallaşdıran kodu burada yoxlamaq olmur.
  • Real CSS yoxdur. Default olaraq Vitest import olunan CSS fayllarını boş sətirlə əvəz edir (onun css.include seçimi boşdur), ona görə stylesheet-in sənədə heç vaxt çatmır. toBeVisible() onda yalnız inline stilləri və hidden atributunu görür: .is-collapsed { display: none } ilə gizlədilmiş panel görünən sayılır. Hover stilləri, media query-lər, :focus-visible və elementlərin üst-üstə yerləşmə sırası (stacking order) da burada mövcud deyil.
  • Hit testing yoxdur. user-event sənədləri qeyd edir ki, jsdom-da elementlərin yeri və ölçüsü yoxdur, ona görə user-event pointer əməliyyatının həmin yerdə mümkün olub-olmadığını yoxlamır: real səhifədə overlay-in örtdüyü düyməyə də klikləyir.
  • Çatışmayan API-lər. jsdom-da IntersectionObserver, ResizeObserver və matchMedia yoxdur. Onları stub edə bilərsən, amma onda test sənin stub-ını yoxlayır. happy-dom daha sürətlidir, amma Vitest-in sözləri ilə, onda bəzi API-lər çatışmır.
TSX
test("opens the answer", async () => {
  const user = userEvent.setup();
  render(<Faq />);
  const question = screen.getByRole("button", { name: "Shipping times" });
  await user.click(question);

  expect(question).toHaveAttribute("aria-expanded", "true");
  // Brauzerdə CSS class cavabı hələ də gizlətsə belə, jsdom-da keçir
  expect(screen.getByText(/ships within/i)).toBeVisible();
});

jsdom-un görə bildiklərini yoxla: aria-expanded vəziyyətini, hidden atributunu, mətni. toBeVisible()-in keçməsini CSS-in elementi göstərdiyinə sübut sayma.

Real brauzer nə vaxt lazımdır

jsdom testlərini məntiq və davranış üçün saxla: nə render olunur, klik nəyi dəyişir, form nə göndərir. Yoxlama layout-dan, scroll-dan, görünməni CSS-in həll etməsindən, fokus stillərindən, drag and drop-dan və ya jsdom-da olmayan brauzer API-lərindən asılıdırsa, onu real brauzerə köçür. Vitest-in Browser Mode-u komponent testlərini Playwright və ya WebdriverIO vasitəsilə real brauzerdə işə salır, Playwright ilə yazılmış isə bütün tətbiqi idarə edir. Vitest sənədləri səbəbini izah edir: simulyasiya olunmuş mühit real mühitdən fərqlənə bilər, ona görə test nəticələrində false positive və false negative-lər mümkündür. Rol və label üzrə query-lər hər ikisində var, ona görə vərdişlər orada da işə yarayır.

Bilməli olduğun bir qiymət: böyük DOM-da getByRole ən yavaş query-dir, çünki rolları hesablayır və görünməni yoxlayır. Sürət vacib olan yerdə sənədlər { hidden: true } təklif edir. Bu, görünmə yoxlamalarını ötürür, amma əlçatan olmayan elementləri də qaytarır, ona görə onu düşünərək işlət.

SeniorTipik səhvlər

Səhv səbəbdən düşən və ya heç vaxt düşməyən testlər

İki növ UI testi ən baha başa gəlir: istifadəçi üçün heç nə pozulmayanda düşənlər və nəsə pozulanda keçənlər.

Səhv səbəbdən düşənlər

  • CSS class və ya DOM strukturu üzrə axtarış: container.querySelector(".btn-primary"), container.firstChild. React Testing Library sənədləri deyir: elementləri tapmaq üçün container-dən istifadə etdiyini görürsənsə, yenidən düşün. Belə testi stilin dəyişməsi uğursuz edir, işləməyən düymə isə uğursuz etmir.
  • Əsas assertion kimi bütün ağacın snapshot-ı. Markup-dakı hər dəyişiklik onu uğursuz edir, reviewer-lər isə yenilənmiş snapshot-ları oxumadan qəbul etməyə öyrəşir.
  • Uzun, dəqiq sətirlər. getByText("Your order #1042 has been placed and will ship within 2 business days") mətndəki hər redaktədə düşür. Sabit hissəni regex ilə yoxla və ya elementi rolu ilə tap.
  • Uşaq komponentləri stub-larla əvəz etmək ki, valideyn ayrıca test olunsun. Test onda istifadəçinin aldığını yox, stub-lar arasındakı əlaqəni yoxlayır.

Heç vaxt düşməyənlər

  • Hər yerdə test ID-lər. Düymə görünən label-ini itirəndə və ya klaviaturanın çata bilmədiyi div-ə çevriləndə də getByTestId("submit") keçir.
  • Test üçün əlavə edilmiş ARIA. getByRole tapsın deyə div-ə role="button" qoymaq query-ni keçirir, screen reader istifadəçilərini isə çaşdırır: div-in yenə də klaviatura dəstəyi yoxdur. Real <button> işlət.
  • Heç nə baş verməzdən əvvəl də doğru olan assertion-lar. await olmadan edilmiş klikdən sonra expect(screen.queryByText("Something went wrong")).not.toBeInTheDocument() keçir, çünki klik hələ bitməyib.
  • Hər şeyin ətrafında act. render, fireEvent və user-event artıq act-ə bükülüb. Əlavə örtüklər yalnız səs-küy yaradır; Kent C. Dodds bunu tipik səhvlər sırasına salır.

Testi bir dəfə düşməyə məcbur et

Yeni testə etibar etməzdən əvvəl kodu qəsdən poz: klik handler-ini sil, xəta mətnini dəyiş, <label>-i çıxar. Yaşıl qalan testin heç bir dəyəri yoxdur. eslint-plugin-testing-library bu nümunələrin çoxunu avtomatik tutur, məsələn no-container, no-node-access, prefer-screen-queries, prefer-find-by və no-unnecessary-act qaydaları ilə.

Yaşıl UI testi istifadəçilərin nə edə bildiyi barədə iddiadır. Əmin ol ki, bu iddia yalan da çıxa bilər.

SeniorMüsahibə məsləhətləri

Müsahibə üçün məsləhətlər

30 saniyəlik cavab. "Komponentləri istifadəçinin işlətdiyi kimi test edirəm: render edirəm, elementləri rol və accessible name, ya da label ilə tapıram, user-event ilə qarşılıqlı əlaqəyə girirəm və jest-dom ilə ekrandakını yoxlayıram. State-dən, class adlarından və test ID-lərdən qaçıram ki, refaktorinq testləri uğursuz etməsin, pozulmuş UI isə uğursuz etsin. Default seçimim getBy-dır, queryBy yalnız nəyinsə olmadığını sübut etmək üçündür, findBy isə sonradan görünənlər üçün. jsdom-un hüdudlarını da bilirəm: layout və real CSS yoxdur, ona görə onlardan asılı davranış brauzer testinə gedir."

Gözlənilən suallar

  • Bu düymə üçün hansı query-ni işlədərdin? getByRole("button", { name }). Prioriteti izah et və de ki, düşən role query çox vaxt əlçatanlıq bug-ı deməkdir.
  • getBy, queryBy, yoxsa findBy? Xəta atır, null qaytarır, gözləyir (default 1000 ms). Hər biri üçün uyğun halı adlandır.
  • Niyə fireEvent yox, user-event? Bir event əvəzinə tam qarşılıqlı əlaqə: fokus, klaviatura event-ləri, Enter-in formu göndərməsi, disabled sahəyə yazmamaq.
  • Formu necə test edərdin? İstifadəçi kimi yaz və göndər, mesajı və onun sahə ilə əlaqəsini yoxla, callback-i yoxla, həm düzgün, həm də yanlış yolu əhatə et.
  • İmplementasiya detalı nədir? Kent C. Dodds-un tərifi, bir nümunə və iki uğursuzluq növü: refaktorinqdə düşmək və tətbiq pozulanda keçmək.
  • jsdom testi sənə nəyi deyə bilməz? Layout-u, real CSS-i, scroll-u, observer-ləri, elementin nəyinsə altında qalıb-qalmadığını.

Bal itirməyə səbəb olan səhvlər

  • Rollar və label-lər barədə düşünmədən "data-testid əlavə edərdim" demək.
  • Komponentin state-ini yoxlamaq və ya container.querySelector ilə axtarmaq.
  • Yazı üçün fireEvent, ya da await-siz user-event çağırışları.
  • jsdom-da toBeVisible()-in keçməsini istifadəçinin elementi gördüyünə sübut saymaq.

Senior səviyyəni göstərən məqamlar

Test dəstindən məhsul kimi danış. Rol və label query-ləri eyni zamanda ucuz əlçatanlıq yoxlamasıdır. render-in wrapper seçimi üzərində qurulmuş ortaq render köməkçisi provider-ləri hər testdən kənarda saxlayır. CI-da işləyən eslint-plugin-testing-library adi səhvləri review-dan əvvəl dayandırır. Nəyin Browser Mode-a və ya Playwright-a köçdüyü barədə aydın qayda var. Trade-off-ları bildiyini də göstər: role query-lər nəhəng ağaclarda yavaşdır, amma bu, test ID-lərə qayıtmağa yox, testlərdə daha kiçik ağaclar render etməyə səbəbdir.

JuniorYoxlama siyahısı

UI testlərini review edərkən nəyi yoxlamalı

Yazmadığın komponent testlərini (komanda yoldaşının pull request-ini, kitabxananın nümunəsini, AI assistentin təklifini) review edəndə bu siyahıdan istifadə et. İmplementasiya detallarına söykənən UI testi hər refaktorinqdə düşür, real bug-ları isə yenə də buraxır.

  • Elementlər mətn və test ID-dən əvvəl rol və accessible name, ya da label ilə tapılırmı? Diff-də getByTestId, container.querySelector və class selector-larını axtar; hər birinin səbəbi olmalıdır. Role query screen reader-lərin adlandıra bilmədiyi kontrolu da tutur.
  • Hər qarşılıqlı əlaqə user-event ilə edilib və await olunubmu? Yazı üçün işlədilən fireEvent.change-ə və await-siz user. çağırışlarına bax; çatışmayan await assertion-ın qarşılıqlı əlaqə bitməmiş işləməsinə səbəb olur.
  • Hər query-nin prefiksi niyyətə uyğundurmu? Mütləq olmalı olan üçün getBy, yalnız not.toBeInTheDocument() ilə queryBy, sonradan görünən üçün await olunmuş findBy. getAllBy(...)[0] birmənalı olmayan query-ni gizlədir.
  • Assertion-lar istifadəçinin hiss etdiyini yoxlayırmı? State, render sayı və ya uşaq props-u yox, jest-dom ilə mətn, dəyər, fokus, disabled vəziyyəti və accessible description. Unutma ki, sətirlə çağırılan toHaveTextContent alt sətir axtarır.
  • Funksionallıq pozulanda test düşürmü? Kodu lokal olaraq poz (handler-i sil, label-i çıxar) və testi işə sal; yaşıl qalan test heç nəyi yoxlamır.
  • Cleanup və matcher-lər qurulubmu? Vitest-də globals: true və ya afterEach-də cleanup() çağıran setup faylı, üstəlik @testing-library/jest-dom/vitest. Gah görünüb, gah yox olan "Found multiple elements" xətaları çox vaxt başqa testdən qalmış DOM deməkdir.
  • Hansısa assertion layout-dan və ya CSS-dən asılıdırmı? Class ilə gizlətmə üzərində toBeVisible(), ölçmələr və scroll jsdom-da səhv səbəbdən keçir və ya düşür; bu yoxlamaların yeri brauzer testidir.

Özünü yoxla

  • Məşq

    Kodun nəticəsini təxmin et, açıq müsahibə suallarına cavab ver və özünü qiymətləndir.

    3 nəticə sualı · 3 açıq sual

  • Quiz

    İzahlı test sualları və yekun nəticə.

    7 sual