error: collection could not be loaded
Newman nu găsește sau nu poate citi fișierul colecției: calea e greșită, numele diferă (spații, majuscule) sau colecția nu a fost exportată. Verifică cu ls ce fișiere ai și folosește exact numele lor.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul complet arată motivul:
error: collection could not be loaded
unable to read data from file "Magazin.json"
ENOENT: no such file or directoryENOENT înseamnă că fișierul nu există la calea dată. Alte variante: JSON invalid (fișier trunchiat, salvat greșit) sau un link de colecție fără acces.
Verificări:
- ce fișiere există:
ls. Exportul din Postman creează implicitNume.postman_collection.json; - directorul curent: căile sunt relative la locul de unde rulezi comanda (în CI, rădăcina repository-ului);
- spații în nume: pune calea între ghilimele;
- majuscule: pe Linux (CI),
magazin.json≠Magazin.json.
Newman poate rula și o colecție din URL (API-ul Postman cu cheie), dar fișierul exportat în repository e varianta cea mai simplă pentru CI.
De ce apare: cauzele frecvente
1Nume scurtat
newman run Magazin.jsonnewman run Magazin.postman_collection.jsonExportul are sufixul .postman_collection.json.
2Colecție neexportată
newman run Magazin.postman_collection.json // fișierul nu existăExport din meniul colecției, apoi newman runNewman rulează fișiere, nu colecțiile din aplicație.
Repară eroarea, direct în pagină
Ai rulat newman run Magazin.json -e Dev.postman_environment.json și ai primit collection could not be loaded: colecția nu a fost exportată, iar numele fișierului e altul. Exportă colecția Magazin și rulează Newman cu numele real al fișierului și environment-ul Dev: exit code 0.
Indiciu
Exportul creează Magazin.postman_collection.json; verifică cu ls.
Reparația
Meniul colecției Magazin → Export, apoi:
newman run Magazin.postman_collection.json -e Dev.postman_environment.jsonDe ce merge
Newman citește colecția din fișier. După export, fișierul Magazin.postman_collection.json există, iar comanda îl găsește. Fără export, Newman nu are acces la colecțiile din aplicație. ls îți arată numele exacte ale fișierelor disponibile. După fiecare modificare a colecției în aplicație, exportul trebuie refăcut, altfel Newman rulează versiunea veche.
Alte forme ale mesajului
error: collection could not be loaded: invalid JSONENOENT: no such file or directory, open 'Magazin.json'
Cum o eviți pe viitor
- Ține colecția exportată în repository, cu nume fără spații.
- Rulează
lsînainte să scrii comanda în pipeline. - Reexportă după fiecare modificare a colecției.
- Verifică numele fișierelor în pipeline cu un pas
ls. - Păstrează exporturile într-un folder dedicat, de exemplu
postman/.
Întrebări frecvente
Pot rula direct din Postman Cloud?
Da, cu URL-ul API și o cheie, dar fișierul din repository e mai ușor de versionat.
Ce înseamnă ENOENT?
Error NO ENTry: fișierul sau folderul nu există.
Erori înrudite
error: could not load environment Newman nu găsește fișierul de environment dat cu -e: nu a fost exportat, numele e greșit sau calea e relativă la alt folder. Exportă environment-ul și folosește exact numele fișierului. zsh: command not found: newman Shell-ul nu găsește programul newman: nu e instalat global sau folderul global npm nu e în PATH (ori ai scris greșit comanda). Instalează-l cu npm install -g newman sau rulează-l cu npx newman. error: iteration data could not be loaded Newman nu poate citi fișierul dat cu -d: numele sau calea e greșită, ori conținutul nu e un CSV sau o listă JSON validă. Verifică numele cu ls și formatul fișierului. Î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.
