Error: expect(received).toHaveLength(expected)
Lista (sau textul) are altă lungime decât cea din test. În teste UI apare de obicei cu Received length: 0, pentru că lista a fost citită cu all() sau allTextContents() înainte să se încarce. Pentru elemente din pagină folosește await expect(locator).toHaveCount(n), care așteaptă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Raportul arată Expected length: 8, Received length: 0 și conținutul primit (Received array: []). toHaveLength verifică proprietatea length a unei valori deja calculate: o listă, un string sau orice obiect cu length. Nu are retry: se uită o singură dată.
În testele de interfață, valoarea vine de obicei din locator.all(), allTextContents() sau $$, care întorc ce există în pagină în acel moment. Dacă lista e încărcată asincron (de la API), citirea făcută imediat după goto găsește 0 elemente. De aceea pentru elemente din pagină există toHaveCount, care reîncearcă până la 5 secunde. Alte cauze: filtrul aplicat nu e cel crezut, datele din API sunt altele (paginare: primești doar primele 10), sau verifici lungimea unui obiect ({ products: [...] }), care nu are length deloc.
De ce apare: cauzele frecvente
1Lista citită înainte să se încarce
await page.goto('/#/catalog');
const carduri = await page.getByTestId('product-card').all();
expect(carduri).toHaveLength(8);await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);all() nu așteaptă; produsele vin de la API după câteva sute de ms. toHaveCount reîncearcă până apar.
2Lungimea unui obiect, nu a unei liste
const corp = await raspuns.json();
expect(corp).toHaveLength(3);const corp = await raspuns.json();
expect(corp.items).toHaveLength(3);Un obiect JSON nu are length. Verifică lista din interiorul lui.
3Lungimea unui text cu spații
const cod = await page.getByTestId('order-number').textContent();
expect(cod).toHaveLength(4);const cod = (await page.getByTestId('order-number').textContent()).replace(/\D/g, '');
expect(cod).toHaveLength(4);textContent conține tot textul elementului („Comanda nr. 1001”). Extrage partea care te interesează.
Repară eroarea, direct în pagină
Testul catalogul afișează 8 produse pică cu expect(received).toHaveLength(expected) (Received length: 0): cardurile sunt citite imediat după deschiderea paginii, înainte să vină produsele de la API. Repară verificarea ca să aștepte cele 8 carduri (folosește aserțiunea cu retry pentru locatori), apoi afișează textul din results-count.
import { test, expect } from '@playwright/test';
test('catalogul afișează 8 produse', async ({ page }) => {
await page.goto('/#/catalog');
const carduri = await page.getByTestId('product-card').all();
expect(carduri).toHaveLength(8);
});Indiciu
Există o aserțiune care numără elementele și așteaptă.
Reparația
import { test, expect } from '@playwright/test';
test('catalogul afișează 8 produse', async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
console.log(await page.getByTestId('results-count').textContent());
});De ce merge
locator.all() întoarce elementele existente în momentul apelului. Imediat după goto, catalogul încă afișa „Se încarcă produsele...”, deci lista era goală și toHaveLength(8) a picat.
await expect(page.getByTestId('product-card')).toHaveCount(8) reîncearcă până la 5 secunde, deci trece imediat ce produsele apar. După el, citirea lui results-count e sigură: lista e deja afișată.
Alte forme ale mesajului
Error: expect(received).not.toHaveLength(expected)Error: expect(received).toHaveLength(expected) Matcher error: received value must have a length property whose value must be a number
Cum o eviți pe viitor
- Pentru elemente din pagină:
await expect(locator).toHaveCount(n), niciodatăall()+toHaveLengthimediat după o navigare. - Dacă ai nevoie de listă pentru calcule, așteaptă întâi cu
toHaveCountsautoBeVisible, apoi citește. - Pentru API, afișează o dată răspunsul (
console.log(corp)) ca să vezi forma exactă.
Întrebări frecvente
De ce uneori trece și alteori pică?
Pentru că depinde de cât de repede vine răspunsul API față de citire. E un test instabil (flaky) clasic; toHaveCount elimină cursa.
Ce înseamnă „received value must have a length property”?
Valoarea nu e listă și nici text: de obicei e un obiect, null sau undefined. Afișeaz-o și verifică de unde vine.
Erori înrudite
Error: expect(locator).toHaveCount(expected) failed Locatorul a găsit alt număr de elemente decât ai cerut. Ori locatorul e prea larg (prinde și alte elemente cu același text) sau prea îngust, ori aplicația chiar afișează alt număr. Compară Expected cu Received și numără elementele care te interesează, de exemplu cardurile de produs după data-testid. Error: expect(received).toEqual(expected) // deep equality Obiectul sau lista primită diferă de cea așteptată: alt element, altă ordine, un spațiu în plus sau un tip diferit ("3" față de 3). Compară liniile Expected și Received din raport și corectează valoarea așteptată sau transformă datele (sortare, trim, Number) înainte de comparație. 1 flaky Raportul spune „1 flaky” când un test a picat, apoi a trecut la reîncercare (retries). Cauza tipică: testul citește pagina după o pauză fixă (waitForTimeout) sau cu valori de moment (count(), textContent(), isVisible()). Înlocuiește-le cu aserțiuni care așteaptă: toHaveCount, toHaveText, toBeVisible. Î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.
