Führen Sie End-to-End-Tests (E2E) durch¶

Die E2E-Tests von Gitrust verwenden Playwright, um einen Chromium-Browser gegen eine Instanz der Anwendung zu steuern, die mit einer dedizierten Datenbank und einem Repository-Verzeichnis konfiguriert ist.

Voraussetzungen¶

• Node.js (bereits vorhanden für Tailwind/DaisyUI)
• Lokaler Zugriff auf PostgreSQL (Docker über „database/docker-compose.yml“)
• „psql“, „createdb“, „dropdb“ im PATH verfügbar
• Chromium über Playwright installiert („npx playwright install chromium“)

Bestellungen¶

# Créer (ou remettre à zéro) la base de données de test
npm run test:e2e:setup

# Lancer tous les tests E2E
npm run test:e2e

# Mode debug interactif (inspecteur Playwright, pas-à-pas)
npm run test:e2e:debug

# Mode UI (interface graphique Playwright)
npm run test:e2e:ui

# Consulter le rapport HTML après exécution
npm run test:e2e:report

Architektur¶

.env.test                         # Variables d'environnement de test
playwright.config.ts              # Configuration Playwright

scripts/
  e2e-setup-db.sh                 # Crée la DB gitrust_test + nettoie depot_test
  e2e-server.sh                   # Démarre l'app avec .env.test

tests/e2e/
  fixtures.ts                     # Fixtures partagées (loginAs, credentials)
  global-setup.ts                 # Seed : crée les utilisateurs via /register
  global-teardown.ts              # Nettoyage post-tests
  auth.spec.ts                    # Tests d'authentification
  repository.spec.ts              # Tests de gestion des dépôts
  admin.spec.ts                   # Tests du panneau d'administration
  navigation.spec.ts              # Tests de navigation et UI

Isolierung der Testumgebung¶

Funktion¶

1. npm run test:e2e:setup löscht die Datenbank „gitrust_test“, erstellt sie neu und leert „depot_test/“.
2. Playwright startet die Anwendung automatisch über „scripts/e2e-server.sh“, das die Variablen aus „.env.test“ lädt, bevor „cargo run“ ausgeführt wird.
3. Das globale Setup erstellt die Testbenutzer (Alice, Bob, Charlie) mithilfe des „/register“-Formulars – 100 % E2E-Ansatz, keine direkte Einfügung in die Datenbank.
4. Die Tests werden nacheinander ausgeführt (ein einzelner Worker), um Konflikte in der gemeinsam genutzten Datenbank zu vermeiden.
5. Der global-teardown wird am Ende der Sitzung ausgeführt.

Vorrichtungen¶

Die Datei „fixtures.ts“ stellt ein „loginAs“-Fixture bereit, das in allen Tests wiederverwendbar ist:

import { test, expect } from './fixtures';

test('mon test', async ({ page, loginAs }) => {
  await loginAs('alice');
  // alice est connectée, on peut naviguer
});

Verfügbare Benutzer: „admin“, „alice“, „bob“, „charlie“.

Liste der Tests¶

„auth.spec.ts“ – Authentifizierung¶

„repository.spec.ts“ – Repository-Verwaltung¶

„admin.spec.ts“ – Verwaltung¶

„navigation.spec.ts“ – Navigation und Benutzeroberfläche¶

Fügen Sie einen neuen Test hinzu¶

1. Erstellen Sie eine Datei „tests/e2e/mon-module.spec.ts“.
2. Fixtures importieren: import { test, Expect } from './fixtures';
3. Verwenden Sie „loginAs“ für Tests, die eine Authentifizierung erfordern
4. Führen Sie es mit „npm run test:e2e“ aus oder zielen Sie auf die Datei: „npx playwright test my-module“.