AssertionError: expected response to have header with key 'X-Total-Items'
Răspunsul nu are antetul pe care îl cere testul. Verifică în tabul Headers numele exact (aici API-ul folosește X-Total-Count) și dacă endpoint-ul chiar trimite acel antet (listele da, un singur produs nu).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
pm.response.to.have.header("nume") verifică existența unui antet. Numele nu țin cont de majuscule, dar trebuie să fie exact același cuvânt.
Cauze:
- nume din alt API:
X-Total-Items,X-Total,Total-Countîn loc deX-Total-Count; - endpoint diferit: antetul de paginare e doar pe liste,
Locationdoar pe creări (201); - proxy sau CDN care elimină antete necunoscute;
- CORS: în browser, unele antete nu sunt expuse (în Postman nu e cazul).
Tabul Headers al răspunsului arată lista completă.
Antetele sunt la fel de importante ca body-ul: paginarea, cache-ul și securitatea depind de ele.
De ce apare: cauzele frecvente
1Nume greșit
pm.response.to.have.header("X-Total-Items");pm.response.to.have.header("X-Total-Count");Numele vine din documentația API-ului.
2Antet pe endpoint-ul greșit
pm.response.to.have.header("Location"); // GETpm.response.to.have.header("Location"); // pe POST cu 201Location apare la crearea unei resurse.
Repară eroarea, direct în pagină
Testul cererii „Listă produse” cere antetul X-Total-Items și pică. API-ul trimite totalul în antetul X-Total-Count (vezi tabul Headers). Corectează testul, salvează și trimite: testul trebuie să treacă.
Indiciu
Numele exact e în tabul Headers al răspunsului.
Reparația
pm.test("Lista are totalul în antet", function () {
pm.response.to.have.header("X-Total-Count");
});De ce merge
X-Total-Items nu există în acest API. Antetul de paginare se numește X-Total-Count. X-Total-Count e numele folosit de acest API pentru totalul listei. Cu numele corect, testul confirmă că antetul de paginare există, iar dacă dispare la o versiune nouă, testul pică.
Alte forme ale mesajului
AssertionError: expected response to have header with key 'Location'
Cum o eviți pe viitor
- Copiază numele antetelor din tabul Headers.
- Verifică și valoarea, nu doar existența.
- Grupează testele de antete pe tipuri de endpoint (liste, creări).
- Verifică și valoarea antetelor importante, nu doar existența.
- Verifică antetele pe tipul potrivit de endpoint: liste, creări, erori.
Întrebări frecvente
Contează majusculele în numele antetului?
Nu; x-total-count și X-Total-Count sunt același antet.
Cum citesc valoarea?
pm.response.headers.get("X-Total-Count"), care întoarce text.
Erori înrudite
AssertionError: expected 'application/json; charset=utf-8' to equal 'application/json' Antetul Content-Type conține și setul de caractere (; charset=utf-8), deci nu e egal cu „application/json”. Verifică doar că include application/json, nu egalitatea exactă. There was an error in evaluating the Post-response Script: AssertionError: expected '13' to equal '30' Un pm.expect scris direct în script, nu în interiorul unui pm.test, nu devine test roșu: aruncă eroare și oprește tot scriptul, deci testele de după nu mai rulează. Pune fiecare aserțiune într-un pm.test. 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.
