error: missing required argument 'collection'
newman run are nevoie, imediat după run, de fișierul (sau URL-ul) colecției. Dacă începi direct cu opțiuni (-e, -d), Newman nu are ce rula. Pune colecția ca prim argument.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Sintaxa este:
newman run <colecție> [opțiuni]Primul argument după run e colecția: un fișier .postman_collection.json sau un URL. Mesajul apare când:
- ai uitat colecția (
newman run -e Dev.postman_environment.json); - o variabilă din pipeline e goală (
newman run $COLLECTION -e ...cuCOLLECTIONnedefinit); - ai pus opțiunile înaintea colecției.
În CI, verifică variabilele folosite în comandă (afișează-le cu echo sau folosește valori implicite).
Comanda newman run fără niciun argument dă aceeași eroare, utilă ca verificare că Newman e instalat corect.
De ce apare: cauzele frecvente
1Colecția lipsă
newman run -e Dev.postman_environment.jsonnewman run Magazin.postman_collection.json -e Dev.postman_environment.jsonColecția e argument obligatoriu.
2Variabilă goală în CI
newman run $COLECTIE -e Dev.postman_environment.jsonCOLECTIE=Magazin.postman_collection.json
newman run "$COLECTIE" -e Dev.postman_environment.jsonO variabilă nedefinită dispare din comandă.
Repară eroarea, direct în pagină
Comanda newman run -e Dev.postman_environment.json dă missing required argument 'collection'. Rescrie comanda cu colecția exportată Magazin pe primul loc după run și rulează: exit code 0.
Indiciu
Sintaxa e newman run <colecție> [opțiuni].
Reparația
newman run Magazin.postman_collection.json -e Dev.postman_environment.jsonDe ce merge
Colecția e argumentul obligatoriu al lui newman run. Cu ea pe primul loc, opțiunea -e se aplică normal, iar rularea pornește. Ordinea opțiunilor de după colecție nu contează. Exit code 0 confirmă rularea reușită. Comanda completă poate fi salvată ca script npm.
Cum o eviți pe viitor
- Scrie comanda completă într-un script npm.
- Pune variabilele de shell între ghilimele.
- Testează comanda local înainte de pipeline.
- Verifică variabilele de shell înainte de comandă.
- Folosește
set -uîn scripturi, ca variabilele nedefinite să oprească execuția.
Întrebări frecvente
Pot da un URL în loc de fișier?
Da, un link de colecție (cu cheie API) e acceptat.
Contează ordinea opțiunilor?
Opțiunile pot fi în orice ordine, dar după colecție.
Erori înrudite
error: unknown option '--enviroment' Newman nu recunoaște o opțiune din comandă: de obicei e scrisă greșit (--enviroment în loc de --environment) sau vine din altă unealtă. Verifică lista cu newman run -h și folosește forma scurtă -e. 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. 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. Î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.
