...
Greșeală frecventă Testare manuală · API și baza de date

Tipurile din răspunsul JSON neverificate („249” text în loc de 249 număr)

Pe scurt

`"pret": "249"` și `"pret": 249` arată la fel la o privire rapidă, dar primul e text, al doilea număr. Dacă verifici doar valoarea, nu vezi diferența, iar aplicația care folosește API-ul poate calcula greșit. Verifică și tipul fiecărui câmp, după documentație sau schemă.

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

Ce înseamnă

Un răspuns JSON are, pentru fiecare câmp, o valoare și un tip: număr, text (string), boolean, listă, obiect sau null. Documentația API-ului (sau schema JSON) spune ce tip are fiecare câmp. Clienții API-ului se bazează pe asta: aplicația mobilă adună prețul cu transportul, filtrează produsele disponibile după true / false.

Când tipul se schimbă (de obicei după o modificare pe server, o conversie sau o altă bază de date), valoarea poate arăta identic. În interfața Postman, "249" și 249 diferă doar prin ghilimele. Dar în JavaScript, "249" + 15 dă "24915", iar "false" e considerat adevărat.

Verificarea tipurilor se face cu o schemă JSON sau cu teste care verifică explicit tipul. Atenție și la null în locul unui câmp lipsă și la numerele trimise ca text cu virgulă („249,00”).

De ce apare: cauzele frecvente

1Doar valoarea comparată

Greșit
pm.expect(json.pret == 249).to.be.true  // trece și pentru "249"
Corect
pm.expect(json.pret).to.be.a("number");
pm.expect(json.pret).to.eql(249);

Comparația cu == convertește tipurile; verificarea explicită a tipului prinde textul.

2Boolean trimis ca text

Greșit
"disponibil": "false"  → verificat din ochi: „false”, Pass
Corect
"disponibil": false  (boolean, fără ghilimele)

Textul "false" e evaluat ca adevărat în multe limbaje, deci produsul indisponibil apare disponibil.

Repară tu

Corectează greșeala, direct în pagină

Verifici răspunsul GET /produse/5 din API-ul ShopRapid. Valorile par corecte, dar nu te-ai uitat la tipuri. Răspunde la întrebările din tab-ul Quiz ca să recunoști tipurile din JSON și să decizi ce e bug.

Indiciu

Uită-te după ghilimele: ele transformă orice valoare în text.

Alte forme ale mesajului

  • JSON schema validation
  • Wrong data type in API response
  • String instead of number in JSON

Cum o eviți pe viitor

  • Citește documentația și notează tipul fiecărui câmp important.
  • Validează răspunsul cu o schemă JSON, dacă echipa are una.
  • Uită-te după ghilimele la numere și booleeni.
  • Testează și câmpurile null și câmpurile lipsă, separat.
  • Verifică tipurile și după fiecare schimbare pe server, ca parte din regresie.

Întrebări frecvente

E bug dacă API-ul trimite prețul ca text, dar aplicația merge?

Dacă documentația spune număr, da: alt client (sau o versiune viitoare) se poate baza pe tipul documentat. Raportează-l cu severitatea potrivită impactului.

Ce e o schemă JSON?

O descriere a structurii răspunsului: ce câmpuri există, ce tip au, care sunt obligatorii. Postman poate valida automat răspunsul față de ea.

Greșeli înrudite

← Toate greșelile Testare manuală

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

Curs Testare manuală (QA): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.