...
Eroare Testare automată · Aserțiuni expect care pică

Error: expect(received).toHaveLength(expected)

Pe scurt

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

Greșit
JavaScript
await page.goto('/#/catalog');
const carduri = await page.getByTestId('product-card').all();
expect(carduri).toHaveLength(8);
Corect
JavaScript
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

Greșit
JavaScript
const corp = await raspuns.json();
expect(corp).toHaveLength(3);
Corect
JavaScript
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

Greșit
JavaScript
const cod = await page.getByTestId('order-number').textContent();
expect(cod).toHaveLength(4);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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ă.

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() + toHaveLength imediat după o navigare.
  • Dacă ai nevoie de listă pentru calcule, așteaptă întâi cu toHaveCount sau toBeVisible, 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

← Toate erorile Testare automată

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.