toHaveText și toContainText
Cele mai multe verificări dintr-o aplicație sunt despre text: un mesaj de eroare, un preț, numărul de rezultate. În această lecție revenim la ShopRapid și alegi corect între textul exact (toHaveText), o parte din text (toContainText) și un tipar (RegExp).
Textul exact: toHaveText
await expect(locator).toHaveText('...') trece doar dacă textul întreg al elementului este cel dat. Spațiile de la început și de la sfârșit nu contează, iar mai multe spații la rând sunt tratate ca unul singur (textul este „normalizat”).
import { test, expect } from '@playwright/test';
test('titlul paginii principale', async ({ page }) => {
await page.goto('/');
await expect(page.getByRole('heading', { level: 1 })).toHaveText('Bine ai venit la ShopRapid');
});
Running 1 test using 1 worker ✓ 1 exemplu.spec.js › titlul paginii principale 1 passed
Opțiunea level: 1 alege titlul de nivel 1 (h1). Pagina mai are un titlu, „Newsletter”, de alt nivel.
Scrie testul mesajele din catalog: deschide catalogul (/#/catalog) și verifică cu toHaveText că elementul getByTestId('results-count') are textul exact 8 produse. Apoi deschide pagina principală (/) și verifică cu toContainText că titlul de nivel 1 (getByRole('heading', { level: 1 })) conține ShopRapid.
- goto('/#/catalog') și toHaveText('8 produse') pe results-count.
- goto('/') și toContainText('ShopRapid') pe titlul de nivel 1.
Soluția exercițiului
import { test, expect } from '@playwright/test';
test('mesajele din catalog', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('results-count')).toHaveText('8 produse');
await page.goto('/');
await expect(page.getByRole('heading', { level: 1 })).toContainText('ShopRapid');
}); Vrei să afli mai mult?O parte din text: toContainText · Un tipar: RegExp · Numărul de produse din catalog · Greșeli frecvente · Rezumat
O parte din text: toContainText
toContainText('...') trece dacă textul dat apare undeva în element. Este util când restul textului nu te interesează sau se schimbă.
import { test, expect } from '@playwright/test';
test('bun venit', async ({ page }) => {
await page.goto('/');
const titlu = page.getByRole('heading', { level: 1 });
await expect(titlu).toContainText('ShopRapid');
await expect(titlu).toContainText('Bine ai venit');
});
Running 1 test using 1 worker ✓ 1 exemplu.spec.js › bun venit 1 passed
| Text pe pagină: „Bine ai venit la ShopRapid” | Rezultat |
|---|---|
| toHaveText('Bine ai venit la ShopRapid') | ✓ trece |
| toHaveText('ShopRapid') | ✘ pică (nu e textul întreg) |
| toContainText('ShopRapid') | ✓ trece |
| toContainText('shoprapid') | ✘ pică (literele mari contează) |
Un tipar: RegExp
Ambele matchere acceptă un RegExp. Este ideal pentru valori care se schimbă, dar au o formă cunoscută, de exemplu un preț care se termină în „lei”:
import { test, expect } from '@playwright/test';
test('prețul are moneda', async ({ page }) => {
await page.goto('/#/produs/1');
const pret = page.getByTestId('product-price');
await expect(pret).toHaveText(/lei$/);
console.log(await pret.textContent());
});
Running 1 test using 1 worker 3.499,00 lei ✓ 1 exemplu.spec.js › prețul are moneda 1 passed
getByTestId('product-price') găsește elementul după atributul data-testid="product-price", pus de developeri special pentru teste. Îl vom studia în lecția 27; deocamdată folosește-l așa cum apare în exemple.
Numărul de produse din catalog
Catalogul afișează câte produse se văd, în elementul results-count. Textul apare după ce produsele s-au încărcat; toHaveText reîncearcă singur până apare, deci nu ai nevoie de nicio pauză.
import { test, expect } from '@playwright/test';
test('numărul de produse', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('results-count')).toContainText('produse');
console.log(await page.getByTestId('results-count').textContent());
});
Running 1 test using 1 worker 8 produse ✓ 1 exemplu.spec.js › numărul de produse 1 passed
Când știi valoarea exactă din cerință, folosește toHaveText: prinde mai multe greșeli. toContainText este potrivit când doar o parte a textului contează sau restul variază.
Greșeli frecvente
- toContainText('8') pentru numărul de produse: ar trece și pentru „18 produse” sau „80 produse”. Preferă toHaveText('8 produse').
- toHaveText pe un câmp de formular: pentru câmpuri folosește toHaveValue.
- Un RegExp între ghilimele ('/lei$/'): devine text obișnuit și caută literal „/lei$/”.
Rezumat
- toHaveText: textul întreg (normalizat), cel mai strict.
- toContainText: o parte din text.
- Ambele acceptă RegExp (/lei$/) și reîncearcă până la 5 secunde.
