Primul expect: toHaveURL și toHaveTitle
O aserțiune (assertion) este verificarea care decide dacă testul trece sau pică. În această lecție înțelegi de ce fără aserțiuni un test nu verifică nimic și folosești primele două: toHaveURL pentru adresă și toHaveTitle pentru titlu.
Ce este o aserțiune
În testarea manuală, la final compari ce vezi cu rezultatul așteptat și scrii „Trecut” sau „Picat”. În cod, comparația o face expect: îi dai ce verifici (pagina, un element, o valoare) și condiția (toHaveTitle, toHaveURL, ...).
await expect(page).toHaveTitle('Catalog | ShopRapid');
// ^ce verifici ^condiția (matcher-ul) ^valoarea așteptată
Funcția de după punct se numește matcher. Dacă condiția este îndeplinită, testul merge mai departe; dacă nu, testul se oprește și este marcat cu ✘.
Scrie două teste pentru pagina coșului (/#/cos): coșul are titlul corect, care verifică titlul Coșul meu | ShopRapid cu toHaveTitle, și adresa coșului, care verifică adresa cu toHaveURL(/cos/).
- În primul test: goto('/#/cos') și toHaveTitle('Coșul meu | ShopRapid').
- În al doilea test: goto('/#/cos') și toHaveURL(/cos/).
- Rulează: raportul trebuie să arate 2 passed.
Soluția exercițiului
import { test, expect } from '@playwright/test';
test('coșul are titlul corect', async ({ page }) => {
await page.goto('/#/cos');
await expect(page).toHaveTitle('Coșul meu | ShopRapid');
});
test('adresa coșului', async ({ page }) => {
await page.goto('/#/cos');
await expect(page).toHaveURL(/cos/);
}); Vrei să afli mai mult?Un test fără aserțiuni trece mereu · toHaveTitle: titlul paginii · toHaveURL: adresa paginii · Greșeli frecvente · Rezumat
Un test fără aserțiuni trece mereu
Testul de mai jos are un titlu promițător, dar deschide pagina greșită și tot trece, pentru că nu verifică nimic:
import { test, expect } from '@playwright/test';
test('catalogul se deschide', async ({ page }) => {
await page.goto('/#/cos');
});
Running 1 test using 1 worker ✓ 1 exemplu.spec.js › catalogul se deschide 1 passed
Adaugă aserțiunea și testul arată imediat problema:
import { test, expect } from '@playwright/test';
test('catalogul se deschide', async ({ page }) => {
await page.goto('/#/cos');
await expect(page).toHaveTitle('Catalog | ShopRapid');
});
Running 1 test using 1 worker
✘ 1 exemplu.spec.js › catalogul se deschide
1 failed
exemplu.spec.js › catalogul se deschideUn test cu ✓ dar fără expect îți dă o încredere falsă. Regula: fiecare test se termină cu cel puțin o verificare a rezultatului așteptat.
toHaveTitle: titlul paginii
await expect(page).toHaveTitle('...') compară titlul exact. Poți folosi și o expresie regulată (RegExp) când te interesează doar o parte: /ShopRapid/ înseamnă „titlul conține ShopRapid”.
import { test, expect } from '@playwright/test';
test('titlurile paginilor', async ({ page }) => {
await page.goto('/#/login');
await expect(page).toHaveTitle('Autentificare | ShopRapid');
await expect(page).toHaveTitle(/ShopRapid$/);
});
Running 1 test using 1 worker ✓ 1 exemplu.spec.js › titlurile paginilor 1 passed
toHaveURL: adresa paginii
await expect(page).toHaveURL(...) verifică adresa curentă. Primește un text (relativ la baseURL sau complet) sau un RegExp. RegExp-ul este cel mai folosit, pentru că adresele conțin des părți variabile.
| Scrii | Trece dacă adresa |
|---|---|
| toHaveURL('/#/catalog') | este exact http://localhost:3000/#/catalog |
| toHaveURL('http://localhost:3000/#/catalog') | este exact adresa dată |
| toHaveURL(/catalog/) | conține „catalog” oriunde |
import { test, expect } from '@playwright/test';
test('contul cere autentificare', async ({ page }) => {
await page.goto('/#/cont');
await expect(page).toHaveURL(/login/);
console.log(page.url());
});
Running 1 test using 1 worker http://localhost:3000/#/login?next=%2Fcont&motiv=cont ✓ 1 exemplu.spec.js › contul cere autentificare 1 passed
Aplicația te-a trimis la login, iar adresa conține și informații în plus (next=...). Un text exact ar fi greu de scris; /login/ verifică exact ce contează.
Greșeli frecvente
- Uiți await în fața lui expect: verificarea nu mai este așteptată, iar testul se poate termina înainte de ea.
- Scrii expect(page.title()) în loc de expect(page).toHaveTitle(...): toHaveTitle se aplică paginii, nu textului.
- RegExp între ghilimele: toHaveURL('/cos/') caută adresa exactă http://localhost:3000/cos/. Un RegExp se scrie fără ghilimele: /cos/.
Rezumat
- Aserțiunea (expect(...).matcher(...)) decide dacă testul trece; fără ea testul trece mereu.
- toHaveTitle verifică titlul paginii, toHaveURL adresa; ambele acceptă text exact sau RegExp.
- Pune mereu await în fața lui expect.
