← React / TypeScript

React / TypeScript · 20 / 24

React-Web-Routing und Deep Links

Du öffnest einen Datensatz direkt über seine URL und behandelst unbekannte IDs.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: Erste React-App: JSX, Props und State, Formulare, Listen und Effects

In diesem Tutorial
  1. Das Zustandsmodell verstehen
  2. Das Projekt starten
  3. Den Vertrag mit einem Test prüfen
  4. Fehler und technische Grenzen beobachten
  5. Die Übung umsetzen
  6. Die Musterlösung überprüfen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

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.

src/App.tsx · typescriptDatei öffnen
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.

package.json · jsonDatei öffnen
{
  "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.

src/App.test.tsx · typescriptDatei öffnen
// @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 build
Erwartetes Ergebnis

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.

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.

Erwartetes Ergebnis

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.

solution/App.test.tsx · typescriptDatei öffnen
// @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.