Einrichtung und Prüfstand
Node.js ab 22.23 mit npm. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.
Geprüft am 20.10.2026 unter Linux x86_64. Komponenten- und Chromium-Tests prüfen direkte Detail-URLs, Browser-Reload, Zurück-Navigation und unbekannte IDs. Der Vite-Server liefert den nötigen App-Routen-Fallback. Ein anderer Produktionsserver muss diesen separat konfigurieren.
Eine Route beschreibt einen adressierbaren Zustand. Der Pfad enthält eine stabile ID statt eines kopierten Datensatzes. Beim direkten Öffnen und nach einem Reload wird der Datensatz erneut aus derselben Quelle bestimmt. Ein nicht existierender Datensatz ist ein anderer Fehler als eine unbekannte Route.
Paketinhalt und einzelne Dateien
01Das Zustandsmodell verstehen
Die URL enthält die Ressourcen-ID. Eine Detailansicht liest diese ID und sucht den passenden Datensatz. Dadurch bleibt die Adresse teilbar. Eine unbekannte ID erhält einen eigenen Zustand, statt versehentlich den ersten Datensatz zu zeigen.
import {
BrowserRouter,
Routes,
Route,
Link,
useParams,
} from "react-router-dom";
const vehicles: Record<string, string> = {
car: "Family car",
bike: "Motorbike",
};
function Detail() {
const { id } = useParams();
return (
<main>
<h1>{(id && vehicles[id]) || "Vehicle not found"}</h1>
<Link to="/">All vehicles</Link>
</main>
);
}
export function Screens() {
return (
<Routes>
<Route
path="/"
element={
<main>
<h1>Vehicles</h1>
<Link to="/vehicles/car">Family car</Link>
</main>
}
/>
<Route path="/vehicles/:id" element={<Detail />} />
<Route path="*" element={<h1>Page not found</h1>} />
</Routes>
);
}
export default function App() {
return (
<BrowserRouter>
<Screens />
</BrowserRouter>
);
}
02Das Projekt starten
Installiere die fest angegebenen Abhängigkeiten und starte npm run dev. Die Daten sind künstliche Lernwerte. Öffne die lokale Adresse und löse die Aktion einmal selbst aus.
{
"name": "appfabrik-learning",
"private": true,
"type": "module",
"scripts": {
"dev": "vite --host 127.0.0.1",
"build": "tsc --noEmit && vite build",
"test": "vitest run src"
},
"dependencies": {
"react": "19.2.3",
"react-dom": "19.2.3",
"react-router-dom": "7.18.4",
"@tanstack/react-query": "5.104.5"
},
"devDependencies": {
"vite": "8.1.5",
"typescript": "6.0.3",
"@types/react": "19.2.14",
"@types/react-dom": "19.2.3",
"@types/node": "22.19.15",
"vitest": "4.1.10",
"@testing-library/react": "16.3.2",
"@testing-library/user-event": "14.6.1",
"jsdom": "29.1.1",
"@playwright/test": "1.64.1"
}
}
03Den Vertrag mit einem Test prüfen
Starte den Test direkt mit einer Detail-URL und prüfe auch eine unbekannte ID. Für einen echten Browser-Reload muss der Webserver unbekannte App-Routen auf index.html zurückführen. Der Router allein konfiguriert den Server nicht.
// @vitest-environment jsdom
import { test, expect, afterEach } from "vitest";
import { render, screen, cleanup } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter } from "react-router-dom";
import { Screens } from "./App";
afterEach(cleanup);
test("direct URL resolves the record and back navigation", async () => {
render(
<MemoryRouter initialEntries={["/vehicles/car"]}>
<Screens />
</MemoryRouter>,
);
expect(screen.getByRole("heading").textContent).toBe("Family car");
await userEvent.click(screen.getByRole("link", { name: "All vehicles" }));
expect(screen.getByRole("heading").textContent).toBe("Vehicles");
});
test("unknown record is explicit", () => {
render(
<MemoryRouter initialEntries={["/vehicles/missing"]}>
<Screens />
</MemoryRouter>,
);
expect(screen.getByRole("heading").textContent).toBe("Vehicle not found");
});
Starten / prüfen
npm install
npm test
npm run buildStarte den Test direkt mit einer Detail-URL und prüfe auch eine unbekannte ID. Für einen echten Browser-Reload muss der Webserver unbekannte App-Routen auf index.html zurückführen. Der Router allein konfiguriert den Server nicht.
04Fehler und technische Grenzen beobachten
Ändere die erwartete Ausgabe und beobachte einen fehlgeschlagenen Test. Ein TypeScript-Build schützt Typverträge, ein Browsertest schützt Interaktionen. Beide Prüfarten erfüllen unterschiedliche Aufgaben.
05Die Übung umsetzen
Prüfe eine unbekannte Route außerhalb von /vehicles.
06Die Musterlösung überprüfen
Der zusätzliche Test öffnet /missing und erwartet Page not found. Für einen Produktionshost muss außerdem die SPA-Fallbackregel direkte Requests auf vorhandene Frontendrouten zum Einstiegspunkt führen. Vite übernimmt dies nur im Lernserver. Kopiere die Lösungsdateien an die entsprechenden Stellen im Lernprojekt und starte Tests und Build erneut.
Tests und Typprüfung bestehen. Das beobachtete Ergebnis entspricht dem Lernziel.
Deine Übung
Prüfe eine unbekannte Route außerhalb von /vehicles.
Lösung mit Erklärung anzeigen
Der zusätzliche Test öffnet /missing und erwartet Page not found. Für einen Produktionshost muss außerdem die SPA-Fallbackregel direkte Requests auf vorhandene Frontendrouten zum Einstiegspunkt führen. Vite übernimmt dies nur im Lernserver.
// @vitest-environment jsdom
import { test, expect, afterEach } from "vitest";
import { render, screen, cleanup } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { MemoryRouter } from "react-router-dom";
import { Screens } from "./App";
afterEach(cleanup);
test("direct URL resolves the record and back navigation", async () => {
render(
<MemoryRouter initialEntries={["/vehicles/car"]}>
<Screens />
</MemoryRouter>,
);
expect(screen.getByRole("heading").textContent).toBe("Family car");
await userEvent.click(screen.getByRole("link", { name: "All vehicles" }));
expect(screen.getByRole("heading").textContent).toBe("Vehicles");
});
test("unknown record is explicit", () => {
render(
<MemoryRouter initialEntries={["/vehicles/missing"]}>
<Screens />
</MemoryRouter>,
);
expect(screen.getByRole("heading").textContent).toBe("Vehicle not found");
});
test("unknown route", () => {
render(
<MemoryRouter initialEntries={["/missing"]}>
<Screens />
</MemoryRouter>,
);
expect(screen.getByRole("heading").textContent).toBe("Page not found");
});
Projektbezug und Quellen
Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.