...
← Curs Test Automation (Playwright și Selenium): toate lecțiile
Lecția 12 · Aserțiuni

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.

Exercițiul tău

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.
await expect(page.getByTestId('results-count')).toHaveText('8 produse');

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');
});
Excelent! Continuă cu lecția următoare →
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
Care alegi?

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.
tests/exemplu.spec.jsPlaywright
Previzualizare
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași în automatizarea testelor Lecția 12 · toHaveText și toContainText
Progres 0% 0 din 22
Lecția curentă 12 / 20 Aserțiuni