From 75a502d708be8d16f89f8d911e563715f1fbaec9 Mon Sep 17 00:00:00 2001 From: natlinux Date: Thu, 16 Oct 2025 20:51:15 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 52 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d8cf9e0..9cfef4c 100644 --- a/README.md +++ b/README.md @@ -44,4 +44,55 @@ This project is a full-stack web application Template combining **ASP.NET Core** - Angular frontend: [http://localhost:44492](http://localhost:44492) - - Swagger UI (API docs): [http://localhost:5184/swagger](http://localhost:5184/swagger) \ No newline at end of file + - Swagger UI (API docs): [http://localhost:5184/swagger](http://localhost:5184/swagger) + + --- + +## 🧪 Angular-Tests ausführen (Wie mache ich Tests in Angular?) + +Die Angular-Frontend-Tests sind mit Karma + Jasmine eingerichtet. Alle Testdateien enden auf `.spec.ts` und liegen neben den jeweiligen Komponenten/Services im Ordner `src/ClientApp/src/`. + +### Schnellstart + +1. Abhängigkeiten installieren (falls noch nicht erledigt): + ```bash + cd src/ClientApp + npm install + ``` +2. Tests im Watch-Modus starten (öffnet den Browser, ideal für Entwicklung): + ```bash + npm test + ``` + +### Headless/CI und Coverage + +- Einmalige Testausführung mit Coverage-Bericht (headless): + ```bash + cd src/ClientApp + npm run test:coverage + ``` + Der Coverage-Report wird unter `src/ClientApp/coverage/` erzeugt (HTML-Report in `index.html`). + +- CI-freundliche Ausführung in Chrome Headless inklusive Coverage: + ```bash + cd src/ClientApp + npm run test:ci + ``` + Hinweis: Für Headless-Tests muss eine Chrome/Chromium-Laufzeit auf der Maschine vorhanden sein. + +### Wo schreibe ich Tests? + +- Komponenten: `src/app/components//.component.spec.ts` +- Services: `src/app/services/.service.spec.ts` +- App-Komponenten: `src/app/app.component.spec.ts` + +Beispiele sind bereits im Projekt vorhanden (z. B. `gitea.service.spec.ts`, `about-me.component.spec.ts`). + +### Nützliche Tipps + +- Testbefehle (npm Scripts) befinden sich in `src/ClientApp/package.json`: + - `npm test` – Watch-Modus mit Browser + - `npm run test:coverage` – Headless, einmalig, mit Coverage + - `npm run test:ci` – Headless, ohne Watch, mit Coverage (für CI) +- Die Angular-CLI liest die Testkonfiguration aus `angular.json` (Target `test`) und `tsconfig.spec.json`. +- Falls Sie auf Servern ohne GUI testen: Verwenden Sie die Headless-Skripte (`test:ci`/`test:coverage`). \ No newline at end of file