...
Eroare Postman · Collection Runner și fișiere de date

Fișierul JSON de date nu e o listă de obiecte

Pe scurt

Runner-ul și Newman acceptă ca fișier de date JSON doar o listă de obiecte: [ {...}, {...} ]. Un obiect cu lista în interior ({"produse": [...]}) nu e acceptat. Scoate lista la rădăcina fișierului.

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

Ce înseamnă

Un fișier de date JSON trebuie să aibă forma:

JSON
[
  { "id": 7, "nume": "Mouse wireless" },
  { "id": 12, "nume": "Webcam HD" }
]

Fiecare obiect e o iterație, iar cheile lui devin variabile. Greșeli frecvente:

  • lista e învelită într-un obiect: { "produse": [ ... ] } (de obicei pentru că fișierul a fost copiat dintr-un răspuns de API);
  • JSON invalid: virgulă după ultimul element, ghilimele simple, comentarii;
  • un singur obiect, fără paranteze drepte.

Runner-ul refuză fișierul (sau face o singură iterație fără date), iar Newman se oprește cu eroare la încărcarea datelor. Validează fișierul într-un editor JSON înainte.

De ce apare: cauzele frecvente

1Listă învelită

Greșit
JavaScript
{ "produse": [ { "id": 7 }, { "id": 12 } ] }
Corect
JavaScript
[ { "id": 7 }, { "id": 12 } ]

Rădăcina trebuie să fie lista.

2Virgulă finală

Greșit
JavaScript
[ { "id": 7 }, ]
Corect
JavaScript
[ { "id": 7 } ]

JSON nu permite virgulă după ultimul element.

Repară tu

Repară eroarea, direct în pagină

Fișierul produse.json are lista învelită într-un obiect ({"produse": [...]}), iar Runner-ul refuză să ruleze colecția Catalog DDT cu el. Rescrie fișierul ca listă de obiecte (aceleași 3 produse) și rulează colecția cu produse.json: 3 iterații, toate testele trecute.

Indiciu

Rădăcina fișierului trebuie să fie [ ... ].

Alte forme ale mesajului

  • The file you selected is not a valid JSON array

Cum o eviți pe viitor

  • Validează fișierele de date cu un formatter JSON.
  • Păstrează fișierele de date în repository, lângă colecție.
  • Previzualizează datele în Runner înainte de rulare.
  • Generează fișierele de date dintr-un script, nu de mână.
  • Previzualizează fișierul în Runner înainte de Run.

Întrebări frecvente

Când aleg JSON în loc de CSV?

Când ai nevoie de tipuri (numere, boolean) sau de valori structurate.

Pot avea obiecte imbricate?

Da, iar cheia de sus devine variabilă; obiectul se citește cu pm.iterationData.get.

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.