Gruparea testelor cu test.describe
Când un fișier are multe teste, le grupezi pe zone ale aplicației: navigare, catalog, coș. Grupul se face cu test.describe, iar numele lui apare în raport înaintea fiecărui test, ca un dosar.
test.describe
test.describe('nume', () => { ... }) primește un nume și o funcție (fără async și fără page) în care scrii testele grupului.
import { test, expect } from '@playwright/test';
test.describe('Pagini', () => {
test('login', async ({ page }) => {
await page.goto('/#/login');
await expect(page).toHaveTitle('Autentificare | ShopRapid');
});
test('coș', async ({ page }) => {
await page.goto('/#/cos');
await expect(page).toHaveTitle('Coșul meu | ShopRapid');
});
});
Running 2 tests using 1 worker ✓ 1 exemplu.spec.js › Pagini › login ✓ 2 exemplu.spec.js › Pagini › coș 2 passed
În raport, fiecare test apare acum ca exemplu.spec.js › Pagini › login: fișier › grup › test. Grupul nu schimbă felul în care rulează testele; fiecare primește în continuare pagina lui nouă.
Scrie grupul Navigare cu două teste. linkul Catalog duce la catalog: deschide /#/login, dă click pe linkul Catalog și verifică toHaveURL(/catalog/). linkul Coș duce la coș: deschide /#/login, dă click pe linkul Coș și verifică toHaveURL(/cos/).
- Pune testele în test.describe('Navigare', () => { ... }).
- Primul test: click pe getByRole('link', { name: 'Catalog' }), apoi toHaveURL(/catalog/).
- Al doilea test: click pe getByRole('link', { name: 'Coș' }), apoi toHaveURL(/cos/).
Soluția exercițiului
import { test, expect } from '@playwright/test';
test.describe('Navigare', () => {
test('linkul Catalog duce la catalog', async ({ page }) => {
await page.goto('/#/login');
await page.getByRole('link', { name: 'Catalog' }).click();
await expect(page).toHaveURL(/catalog/);
});
test('linkul Coș duce la coș', async ({ page }) => {
await page.goto('/#/login');
await page.getByRole('link', { name: 'Coș' }).click();
await expect(page).toHaveURL(/cos/);
});
}); Vrei să afli mai mult?Grupuri în grupuri · Linkurile din meniul principal · Greșeli frecvente · Rezumat
Grupuri în grupuri
Poți pune un describe în alt describe. Numele se adună în raport:
import { test, expect } from '@playwright/test';
test.describe('ShopRapid', () => {
test.describe('Catalog', () => {
test('are 8 produse', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('results-count')).toHaveText('8 produse');
});
});
});
Running 1 test using 1 worker ✓ 1 exemplu.spec.js › ShopRapid › Catalog › are 8 produse 1 passed
Nu exagera cu nivelurile: unul sau două sunt suficiente. Mai târziu vei vedea că un describe poate avea și pași comuni (de exemplu „deschide catalogul înainte de fiecare test”).
Linkurile din meniul principal
Antetul ShopRapid are meniul principal cu linkurile „Acasă”, „Catalog” și „Coș 0” (numărul de produse din coș face parte din textul linkului). Pe pagina de login nu există alte linkuri cu aceste texte, așa că le găsești simplu, după rol și nume:
import { test, expect } from '@playwright/test';
test('linkul Acasă', async ({ page }) => {
await page.goto('/#/login');
await page.getByRole('link', { name: 'Acasă' }).click();
console.log(page.url());
});
Running 1 test using 1 worker http://localhost:3000/#/ ✓ 1 exemplu.spec.js › linkul Acasă 1 passed
Numele 'Coș' găsește linkul „Coș 0”, pentru că name caută un subșir. Pe pagina principală însă name: 'Catalog' ar găsi și butonul „Vezi catalogul”; vei învăța în lecția 23 cum ceri numele exact.
Greșeli frecvente
- async sau { page } la funcția lui describe: grupul doar strânge teste, nu primește pagină.
- Cod cu await page... direct în describe, în afara unui test: nu există încă nicio pagină acolo.
- Uiți să închizi }); grupului: eroare de sintaxă la sfârșitul fișierului.
Rezumat
- test.describe('Grup', () => { test(...); test(...); }) grupează testele.
- În raport: fișier › Grup › test; grupurile imbricate se adaugă în lanț.
- Gruparea nu schimbă independența testelor.
