AssertionError: expected undefined to be an array
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(cupage,totalală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
pm.expect(j.items).to.be.an("array");pm.expect(j.data).to.be.an("array");Magazinul pune produsele în data.
2Listă la rădăcină
pm.expect(j.data).to.be.an("array"); // /categoriespm.expect(j).to.be.an("array");Unele endpoint-uri întorc lista direct.
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.
Reparația
const j = pm.response.json();
pm.test("Lista de produse", function () {
pm.expect(j.data).to.be.an("array");
});De ce merge
Produsele sunt în câmpul data. items nu există, deci valoarea era undefined; cu câmpul corect, testul confirmă că răspunsul conține o listă și testele pe elemente devin sigure. Același test, pus primul în script, protejează și buclele de după. Numele câmpului vine din răspunsul real.
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
TypeError: j.forEach is not a function Ai apelat forEach pe ceva care nu e listă: de obicei pe tot obiectul răspunsului ({data: [...]}) în loc de lista din el. Parcurge câmpul cu lista (j.data.forEach) sau, pentru obiecte, Object.keys(j).forEach. AssertionError: expected undefined to equal 'Mouse wireless' Câmpul pe care îl citești din răspuns nu există, deci valoarea e undefined. De obicei numele câmpului e scris greșit (nume în loc de name) sau e la alt nivel în JSON. Compară calea din test cu body-ul din Pretty. AssertionError: expected [ Array(5) ] to have a length of 10 but got 5 Lista din răspuns are alt număr de elemente decât așteaptă testul. Verifică parametrii cererii (limit, page, filtre) și dacă numărul fix din test mai e corect; de multe ori e mai robust să compari cu limit-ul trimis. Î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.
