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

AssertionError: expected response to have header with key 'X-Total-Items'

Pe scurt

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 de X-Total-Count;
  • endpoint diferit: antetul de paginare e doar pe liste, Location doar 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

Greșit
JavaScript
pm.response.to.have.header("X-Total-Items");
Corect
JavaScript
pm.response.to.have.header("X-Total-Count");

Numele vine din documentația API-ului.

2Antet pe endpoint-ul greșit

Greșit
JavaScript
pm.response.to.have.header("Location");   // GET
Corect
JavaScript
pm.response.to.have.header("Location");   // pe POST cu 201

Location apare la crearea unei resurse.

Repară tu

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.

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

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