newman: could not find "htmlextra" reporter
Reporterii externi (htmlextra, allure) sunt pachete npm separate și trebuie instalați în același loc cu Newman. Instalează-i (npm install -g newman-reporter-htmlextra) sau folosește reporterii incluși: cli, json, junit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Newman are câțiva reporteri incluși: cli (implicit), json, junit, progress, emojitrain. Restul sunt pachete npm cu numele newman-reporter-<nume>:
newman-reporter-htmlextrapentru rapoarte HTML;newman-reporter-allurepentru Allure.
Dacă reporterul nu e instalat, Newman afișează un avertisment de tipul could not find "htmlextra" reporter și rulează fără el, deci raportul așteptat de CI lipsește.
Regula de instalare: în același loc cu Newman. Newman global + reporter global, sau ambele în devDependencies ale proiectului. Pentru CI-uri care afișează rezultate de test (Jenkins, GitLab, Azure DevOps), junit e inclus și e citit nativ.
De ce apare: cauzele frecvente
1Reporter neinstalat
newman run Catalog.postman_collection.json -r htmlextranpm install -g newman-reporter-htmlextra
newman run Catalog.postman_collection.json -r cli,htmlextraReporterii externi se instalează separat.
2Reporter inclus pentru CI
-r htmlextra // doar ca să vadă CI-ul rezultatele-r cli,junit --reporter-junit-export rezultate/catalog.xmlJUnit e inclus și înțeles de serverele CI.
Repară eroarea, direct în pagină
În CI, -r htmlextra dă could not find "htmlextra" reporter, deci raportul lipsește. Până se instalează pachetul, folosește reporterii incluși: rulează colecția exportată Magazin cu environment-ul Dev, reporterii cli și junit, cu raportul în rezultate/magazin.xml. Exit code 0.
Indiciu
--reporter-junit-export stabilește calea fișierului.
Reparația
newman run Magazin.postman_collection.json -e Dev.postman_environment.json -r cli,junit --reporter-junit-export rezultate/magazin.xmlDe ce merge
junit e inclus în Newman, deci nu depinde de pachete instalate separat. Fișierul XML e citit direct de serverele CI, care afișează testele picate în interfața lor. Raportul HTML poate fi adăugat după instalarea pachetului. Calea raportului e fixată explicit în comandă.
Alte forme ale mesajului
newman: could not find "allure" reporterError: Cannot find module 'newman-reporter-htmlextra'
Cum o eviți pe viitor
- Fixează reporterii în
devDependencies, lângă Newman. - Folosește
junitpentru integrarea cu CI șihtmlextrapentru oameni. - Setează explicit calea raportului cu
--reporter-<nume>-export. - Verifică după rulare că fișierul raportului există.
- Instalează reporterii în același pas cu Newman.
Întrebări frecvente
Unde apare raportul junit implicit?
În folderul newman/, cu un nume care include data; e mai clar să dai calea cu --reporter-junit-export.
Pot folosi mai mulți reporteri?
Da, separați prin virgulă: -r cli,junit,htmlextra.
Erori înrudite
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. Newman se termină cu exit code 1 Exit code 1 înseamnă că rularea a avut cel puțin un test picat sau o eroare (cerere eșuată, script cu eroare). Citește tabelul de la final și lista „# failure”, repară cauza în colecție, reexportă și rulează din nou. 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. Î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.
