...
Eroare Postman · Teste care pică: AssertionError

AssertionError: expected undefined to be an array

Pe scurt

Testul verifică o listă dintr-un câmp care nu există. Lista e în alt câmp (de ex. data, nu items sau products) sau răspunsul e o eroare. Citește structura body-ului și folosește numele corect.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

to.be.an("array") pe undefined înseamnă că ai citit un câmp inexistent. API-urile pun listele în câmpuri cu nume diferite:

  • data (cu page, total alături), ca în magazinul demo;
  • items, results, products, content în alte API-uri;
  • direct la rădăcină ([...]), fără obiect înconjurător.

După ce testul de tip trece, testele pe elemente (forEach, lengthOf) devin sigure. De aceea e bine ca testul „lista e o listă” să fie primul în script.

Dacă răspunsul e o eroare (404, 401), lista lipsește complet; verifică întâi statusul, ca mesajul să fie clar.

De ce apare: cauzele frecvente

1Nume de câmp din alt API

Greșit
JavaScript
pm.expect(j.items).to.be.an("array");
Corect
JavaScript
pm.expect(j.data).to.be.an("array");

Magazinul pune produsele în data.

2Listă la rădăcină

Greșit
JavaScript
pm.expect(j.data).to.be.an("array");   // /categories
Corect
JavaScript
pm.expect(j).to.be.an("array");

Unele endpoint-uri întorc lista direct.

Repară tu

Repară eroarea, direct în pagină

Testul cererii „Listă produse” verifică j.items și pică: expected undefined to be an array. Corectează câmpul după structura răspunsului, salvează și trimite: testul trebuie să treacă.

Indiciu

Uită-te în Pretty unde e lista de produse.

Alte forme ale mesajului

  • AssertionError: expected undefined to be an object

Cum o eviți pe viitor

  • Verifică structura cu un test de tip înainte de bucle.
  • Copiază numele câmpului din răspuns.
  • Folosește schemă JSON pentru structuri mai mari.
  • Pune testul de tip primul, înaintea buclelor și a testelor pe elemente.
  • Notează în documentația colecției numele câmpului cu lista.

Întrebări frecvente

De ce nu typeof x === "array"?

typeof dă object pentru liste; folosește Array.isArray sau to.be.an("array").

Testul roșu înseamnă că API-ul are un bug?

Nu neapărat. Întâi verifică dacă testul descrie corect contractul; abia apoi raportează un bug.

Erori înrudite

← Toate erorile Postman

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ță Postman de la zero, cu exerciții la fiecare lecție

Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.