Tipurile din răspunsul JSON neverificate („249” text în loc de 249 număr)
`"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ă
pm.expect(json.pret == 249).to.be.true // trece și pentru "249"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
"disponibil": "false" → verificat din ochi: „false”, Pass"disponibil": false (boolean, fără ghilimele)Textul "false" e evaluat ca adevărat în multe limbaje, deci produsul indisponibil apare disponibil.
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.
Reparația
Răspunsurile corecte:
1. q1: Raportezi bug: tipul e text, nu număr. 2. q2: 249 → număr; "249" → text (string); true → boolean; null → valoare lipsă (null). 3. q3: Fals.
De ce merge
Tipul unui câmp face parte din contractul API-ului, la fel ca valoarea. Un preț trimis ca text arată corect în Postman, dar strică orice calcul din aplicațiile care îl folosesc, iar un boolean trimis ca text poate inversa o condiție.
Verificarea explicită a tipului (cu o schemă sau cu un test pe tip) prinde aceste schimbări imediat, înainte să ajungă la clienți ca totaluri greșite.
Alte forme ale mesajului
JSON schema validationWrong data type in API responseString 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
Verificat doar status 200 la API, nu și corpul răspunsului Un răspuns 200 OK spune doar că cererea a fost procesată, nu că datele sunt corecte: corpul poate avea prețul greșit, un câmp lipsă sau o listă goală. Verifică în fiecare test și corpul: câmpurile obligatorii, tipurile și valorile așteptate. Cereri cu JSON invalid sau câmpuri lipsă netestate (400 Bad Request) Testele API care trimit doar corpuri JSON corecte nu verifică ce face serverul cu datele greșite. Trimite intenționat JSON stricat, câmpuri obligatorii lipsă și tipuri greșite: răspunsul corect e 400 Bad Request (sau 422) cu un mesaj clar, nu 500 și nici 201. Verificat doar interfața, nu și ce s-a salvat în baza de date Mesajul „Comandă plasată” pe ecran nu garantează că în baza de date comanda are totalul corect, liniile de produs și stocul scăzut. Când ai acces, verifică după testele importante și datele salvate, cu un SELECT pe tabelele implicate. Î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.
