Error: expect(locator).toHaveText(expected) failed
Textul elementului nu a devenit egal cu cel așteptat în 5 secunde. Compară rândurile Expected și Received: toHaveText cere tot textul elementului (cu spațiile normalizate), deci pentru o bucată din text folosește toContainText sau o expresie regulată.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
await expect(locator).toHaveText(text) reîncearcă până când textul elementului e egal cu cel dat, implicit 5 secunde. Dacă nu se întâmplă, raportul arată:
Locator:locatorul verificat;Expected:ce ai cerut;Received:ultimul text citit;Call logcu valorile văzute pe parcurs (unexpected value "...").
Cu un șir, comparația e pe tot textul, după ce spațiile multiple și rândurile noi sunt reduse la câte un spațiu; majusculele contează. „148,99 lei” nu e egal cu „Total: 148,99 lei”. Cu o expresie regulată (/148,99 lei/) se caută o potrivire oriunde în text.
Dacă Received e textul așteptat, dar cu altă valoare (de exemplu alt total), testul a găsit poate un bug real. Dacă Received e <element(s) not found>, problema e locatorul.
De ce apare: cauzele frecvente
1Elementul conține mai mult text decât ai scris
await expect(page.getByTestId('cart-total')).toHaveText('148,99 lei');await expect(page.getByTestId('cart-total')).toHaveText('Total: 148,99 lei');toHaveText compară tot textul. Alternativ: toContainText('148,99 lei').
2toHaveText pe un câmp de formular
await expect(page.getByLabel('Email')).toHaveText('ana@shoprapid.ro');await expect(page.getByLabel('Email')).toHaveValue('ana@shoprapid.ro');Un <input> nu are text, are valoare; textul primit e gol.
3Format diferit al numerelor
await expect(page.getByTestId('product-price').first()).toHaveText('3499 lei');await expect(page.getByTestId('product-price').first()).toHaveText('3.499,00 lei');Aplicația formatează prețurile cu punct pentru mii și două zecimale.
Repară eroarea, direct în pagină
În coșul utilizatorului ana@shoprapid.ro e un mouse ergonomic (129,00 lei + livrare 19,99 lei). Testul totalul coșului pică cu expect(locator).toHaveText(expected) failed: Expected: "148,99 lei", Received: "Total: 148,99 lei". Repară aserțiunea ca testul să treacă și să verifice în continuare suma corectă.
import { test, expect } from '@playwright/test';
test('totalul coșului', async ({ page }) => {
await page.goto('/#/cos');
await expect(page.getByTestId('cart-total')).toHaveText('148,99 lei');
});Indiciu
toHaveText compară tot textul elementului.
Reparația
import { test, expect } from '@playwright/test';
test('totalul coșului', async ({ page }) => {
await page.goto('/#/cos');
await expect(page.getByTestId('cart-total')).toHaveText('Total: 148,99 lei');
});De ce merge
Elementul cart-total conține „Total: 148,99 lei”, iar toHaveText cu un șir cere egalitate pe tot textul, deci „148,99 lei” nu se potrivea. Variantele corecte sunt textul complet, toContainText('148,99 lei') sau o expresie regulată.
Am ales textul complet, pentru că verifică și eticheta, nu doar suma. Totalul în sine e corect: 129,00 lei plus 19,99 lei livrare, pentru că o comandă sub 500 de lei are livrare plătită.
Alte forme ale mesajului
Error: Timed out 5000ms waiting for expect(locator).toHaveText(expected)Error: expect(locator).toHaveText(expected) failed Expected string: "148,99 lei" Received string: "Total: 148,99 lei"Error: expect(locator).not.toHaveText(expected) failed
Cum o eviți pe viitor
Copiază textul așteptat din pagină, nu din specificație. Decide clar ce verifici: tot textul (toHaveText), o parte (toContainText) sau un tipar (toHaveText(/Total: \d/)). Pentru câmpuri folosește toHaveValue. Pune await în fața fiecărui expect pe locator: fără el aserțiunea nu așteaptă, iar testul se poate termina înainte de verificare.
Întrebări frecvente
De ce testul așteaptă 5 secunde înainte să pice?
Aserțiunile pe locatori reîncearcă până la expect.timeout (implicit 5000 ms), ca să dea timp aplicației să actualizeze pagina. Poți schimba limita pentru o aserțiune cu { timeout: 10000 }.
Pot ignora majusculele?
Da, cu toHaveText('total: 148,99 lei', { ignoreCase: true }) sau cu o expresie regulată cu flagul i.
Erori înrudite
Error: expect(locator).toContainText(expected) failed Textul elementului nu conține bucata căutată. Cel mai des diferă majusculele, diacriticele sau formularea: toContainText ține cont de literele mari. Compară Expected substring cu Received și scrie bucata exact cum apare, sau adaugă { ignoreCase: true }. Error: expect.toHaveText: Error: strict mode violation: getByTestId('product-price') resolved to 8 elements Aserțiunea toHaveText cu un singur text a primit un locator care găsește mai multe elemente, de exemplu toate prețurile din catalog. Restrânge locatorul la elementul pe care vrei să-l verifici (cardul produsului, rândul din tabel) sau, dacă vrei să verifici toate elementele, dă-i lui toHaveText o listă de texte. Error: expect(locator).toHaveValue(expected) failed Valoarea câmpului nu e cea așteptată. toHaveValue compară toată valoarea din input, textarea sau select, deci o parte din ea nu ajunge; scrie valoarea completă sau folosește o expresie regulată (de ex. /Ana/). Verifică și dacă ai ales câmpul corect. Învață Testare automată de la zero, cu exerciții la fiecare lecție
Curs Test Automation (Playwright și Selenium): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
