README.md aktualisiert

This commit is contained in:
natlinux
2025-10-16 20:51:15 +00:00
parent 46d928a5d1
commit 75a502d708

View File

@@ -45,3 +45,54 @@ This project is a full-stack web application Template combining **ASP.NET Core**
- Angular frontend: [http://localhost:44492](http://localhost:44492) - Angular frontend: [http://localhost:44492](http://localhost:44492)
- Swagger UI (API docs): [http://localhost:5184/swagger](http://localhost:5184/swagger) - 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/<name>/<name>.component.spec.ts`
- Services: `src/app/services/<name>.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`).