...
Eroare Postman · Newman, CI și mock servers

error: missing required argument 'collection'

Pe scurt

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 ... cu COLLECTION nedefinit);
  • 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ă

Greșit
JavaScript
newman run -e Dev.postman_environment.json
Corect
JavaScript
newman run Magazin.postman_collection.json -e Dev.postman_environment.json

Colecția e argument obligatoriu.

2Variabilă goală în CI

Greșit
JavaScript
newman run $COLECTIE -e Dev.postman_environment.json
Corect
JavaScript
COLECTIE=Magazin.postman_collection.json
newman run "$COLECTIE" -e Dev.postman_environment.json

O variabilă nedefinită dispare din comandă.

Repară tu

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].

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

← 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.