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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Newman e un pachet npm, deci are nevoie de Node.js. „command not found” (zsh) sau „'newman' is not recognized” (Windows) înseamnă că shell-ul nu are un program cu acest nume în PATH.
Cauze:
- Newman nu e instalat:
npm install -g newman; - e instalat local în proiect (
npm install --save-dev newman), deci se rulează cunpx newmansau dintr-un script npm; - folderul global npm nu e în PATH (după instalarea cu nvm sau un manager de versiuni, deschide un terminal nou);
- greșeală de tastare:
newmn,newmann.
În CI, pune instalarea ca pas explicit (npm install -g newman sau npm ci cu Newman în devDependencies). În terminalul cursului, Newman e deja instalat.
De ce apare: cauzele frecvente
1Neinstalat
newman run Magazin.postman_collection.jsonnpm install -g newman
newman run Magazin.postman_collection.jsonProgramul trebuie instalat întâi.
2Instalat local în proiect
newman run ...npx newman run ...npx găsește pachetele din node_modules.
Repară eroarea, direct în pagină
Pe laptop ai primit zsh: command not found: newman, pentru că Newman nu era instalat (npm install -g newman). În terminalul cursului e instalat. Verifică versiunea cu newman --version, apoi rulează colecția exportată Magazin cu environment-ul Dev: exit code 0.
Indiciu
Comanda e newman run <colecție> -e <environment>.
Reparația
newman --version
newman run Magazin.postman_collection.json -e Dev.postman_environment.jsonDe ce merge
Când Newman e instalat, comanda e găsită în PATH. Rularea cu colecția și environment-ul exportate trece fără eșecuri, iar exit code 0 îi spune pipeline-ului că pasul a reușit. Pe un calculator nou, instalarea cu npm e primul pas. Versiunea afișată confirmă instalarea.
Alte forme ale mesajului
'newman' is not recognized as an internal or external commandnewman: command not foundbash: newman: command not found
Cum o eviți pe viitor
- Pune Newman în
devDependenciesși rulează-l cunpxsaunpm test. - Verifică instalarea cu
newman --version. - În CI, instalează Node și Newman în pași separați, vizibili.
- Documentează în README comenzile de instalare și rulare.
- Folosește aceeași versiune de Node local și în CI.
Întrebări frecvente
Am nevoie de Node.js?
Da, Newman rulează pe Node.js, deci instalezi întâi Node.
Ce e mai bine: global sau local?
Local, în proiect: versiunea e fixată și aceeași pentru toată echipa.
Erori înrudite
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. Process completed with exit code 1. Mesajul vine de la GitHub Actions: o comandă din pas (aici newman run) a ieșit cu 1. Cauza e în log-ul pasului, mai sus. Frecvent, în CI lipsește o variabilă secretă care local exista în environment; dă-o cu --env-var din secretele pipeline-ului. 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. Î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.
