Zum Inhalt springen
diggn.de
← alle Beiträge Angular & TypeScript · · 3 Minuten

Wie aus meiner 404-Seite die Startseite wurde

Für unbekannte URLs liefert der Webserver eine 404.html aus, und die war auch da. Sie blieb nur nicht stehen.

Angular 22 baut diese Seite mit outputMode: "static": Jede Route wird beim Build zu fertigem HTML, danach gibt es keinen Node-Server mehr, nur noch Dateien. Für eine Handvoll Beiträge ist das genau richtig. Es verschiebt nur eine Frage an eine Stelle, an der ich sie nicht erwartet hatte.

Zwei Hälften einer Antwort

Der Host beantwortet eine unbekannte URL mit der Datei 404.html. Angulars Prerenderer legt die Seite allerdings als 404/index.html ab, und dort sucht sie weder GitLab Pages noch Netlify noch ein nginx mit error_page 404 /404.html. Ein Skript im Build kopiert sie deshalb an die richtige Stelle (tools/make-404.mjs), und geprüft habe ich das gegen einen echten statischen Server:

Shell
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:4422/gibt-es-nicht
# 404

Status 404, richtiger Text, richtiges Layout. An der Stelle hätte ich es abgehakt.

Nur ist die ausgelieferte Datei nicht das Ende. Sie enthält die komplette Anwendung, und sobald die geladen hat, übernimmt der Router. Der schaut sich die Adresszeile an und entscheidet neu, was hier eigentlich stehen soll.

Die Zeile, an der es lag

app.routes.tsTypeScript
{ path: '**', redirectTo: '' }

Das sieht harmlos aus und ist es in einer normalen Single-Page-Anwendung auch. Hier nicht, denn / ist keine Startseite: Es ist die Sprachauswahl, die ohne JavaScript als Seite mit beiden Sprachen stehen bleibt und mit JavaScript sofort auf /de/ oder /en/ weiterleitet.

Die Kette lief damit so: Der Host liefert für /gibt-es-nicht die 404.html aus, mit Status 404. Angular hydriert. Der Router sieht /gibt-es-nicht, findet nur die Catch-all-Route und leitet auf / um. Die Sprachauswahl schickt von dort je nach Browsersprache weiter, bei mir auf /de/. Wer einem toten Link gefolgt ist, landet auf der Startseite und erfährt nie, dass es die gesuchte Seite nicht gibt.

Eine vorgerenderte Seite muss die Übernahme durch das Framework überleben. Was der Server ausliefert, ist nur die erste Hälfte der Antwort.

Warum das so lange unsichtbar war

Im Dev-Server gibt es keine 404.html. Man tippt dort eine kaputte URL, landet auf der Startseite und denkt sich nichts dabei, weil genau das der Fallback einer SPA ist. Der Unterschied zeigt sich erst im gebauten Zustand, und gebaut habe ich vor allem, um zu prüfen, ob alles vorgerendert wird. Die Frage, was danach passiert, hatte ich nie gestellt.

Der Fix ist ein paar Zeilen: Die Catch-all-Route rendert jetzt dieselbe Seite wie /404, im gemeinsamen Layout, statt irgendwohin umzuleiten.

app.routes.tsTypeScript
{
  path: '**',
  component: SiteLayoutComponent,
  data: { locale: DEFAULT_LOCALE },
  children: [{ path: '**', component: NotFoundPage, data: { locale: DEFAULT_LOCALE } }],
}

Festgehalten wird das von einem Test, der genau die Reihenfolge prüft, die mir gefehlt hat: unbekannte URL aufrufen, warten, bis Angular übernommen hat, und erst dann nachsehen, was auf dem Schirm steht.

navigation.spec.tsTypeScript
await page.goto('/gibt-es-weder-hier-noch-dort');
await expect(page.getByRole('heading', { level: 1 })).toHaveText('Diese Seite gibt es nicht.');
await expect(page.locator('header')).toBeVisible();
expect(new URL(page.url()).pathname).toBe('/gibt-es-weder-hier-noch-dort');

Die letzte Zeile ist die wichtige. Ein Test, der nur die Überschrift prüft, hätte auch vorher grün sein können, solange er schnell genug hinschaut.

Seitdem ist vorgerendertes HTML für mich nur der Ausgangszustand. Für jede Seite, die der Build ausspuckt, gibt es zwei Fragen: Was steht drin, und was macht der Router daraus, wenn er wach wird.

#angular#ssg#routing

Ähnliche Beiträge