URL-Pfadsegmente auslesen und in Routen umwandeln

Inhalt
Dieser Beitrag richtet sich an alle, die eine lange URL aus der Adresszeile oder aus einem Log kopiert haben und sie in eine Route übertragen wollen – und dabei unsicher sind, wo der Pfad endet, wo die Query beginnt und welche Teile zu Variablen werden. Vorab die Kurzfassung: Die Zerlegung einer URL folgt einigen wenigen festen Regeln.
Nur die durch Schrägstriche getrennten Pfadteile erhalten einen Index, die Query nach dem ? zählt nicht als Pfadsegment, und ob ein Segment zur Variable wird, entscheidet genau eine feste Bedingung. In diesem Beitrag geht es ausschließlich darum, wie diese Berechnung genau abläuft und wie Sie das Ergebnis lesen.
Zusammenfassung ① Eine URL besteht aus Protokoll (https:), Host (hostname), Pfadsegmenten und Query. Nur die an den Schrägstrichen getrennten Pfadteile erhalten einen Index in der Reihenfolge /0, /1 usw. ② Die Query nach dem
?zählt nicht als Pfadsegment, sondern landet in einer separaten Schlüssel-Wert-Tabelle. Leere Teile, die durch aufeinanderfolgende oder abschließende Schrägstriche entstehen, werden automatisch herausgefiltert. ③ Besteht ein Segment nur aus Ziffern oder hat es neun oder mehr Zeichen, wird es durch einen dynamischen Parameter (:variable / [variable]) ersetzt. Alle anderen Segmente bleiben unverändert.
Pfadsegmente falsch gezählt: Das Problem beim Übertragen langer URLs in Routen
Nehmen wir als Beispiel eine URL wie https://shop.example.com/products/948213/reviews/?sort=recent, die Sie in eine Route übertragen möchten.
Dabei gibt es drei typische Stolperstellen: Ist ?sort=recent ein eigenes Pfadsegment? Erzeugt der Schrägstrich am Ende einen weiteren leeren Teil und verschiebt damit die Indizes? Und soll nur ein Wert wie 948213 als Variable behandelt werden?
Entscheiden Sie diese drei Punkte nach Gefühl, passt die Route leicht nicht mehr zur tatsächlichen Anfrage. Zum Glück sind alle Entscheidungen rein mechanische Regeln: Wer das Prinzip kennt, kommt jedes Mal zum gleichen Ergebnis.
URL ohne Tool zerlegen: nur mit dem Browser
Diese Berechnung lässt sich mit der im Browser eingebauten URL-API direkt nachvollziehen. Fügen Sie dazu Folgendes in die Konsole der Entwicklertools (F12) ein:
const u = new URL("https://shop.example.com/products/948213/reviews/?sort=recent");
u.protocol; // "https:"
u.hostname; // "shop.example.com"
u.pathname; // "/products/948213/reviews/"
u.pathname.split("/").filter(Boolean); // ["products", "948213", "reviews"]
[...u.searchParams]; // [["sort", "recent"]]
Der Ablauf im Einzelnen:
protocolundhostnameliefern zuerst das Protokoll und den Host.pathnamewird an den Schrägstrichen (/) geteilt, anschließend werden leere Zeichenketten herausgefiltert. Dabei verschwinden der leere Teil vor dem ersten Schrägstrich, leere Teile durch aufeinanderfolgende Schrägstriche und der leere Teil nach einem abschließenden Schrägstrich.- Die übrigen Teile werden von vorn mit 0, 1, 2 nummeriert. Das Beispiel oben ergibt also drei Segmente:
products(/0),948213(/1) undreviews(/2). - Die Query nach dem
?wird separat übersearchParamsals Schlüssel-Wert-Paar gelesen. Sie fließt nicht in die Anzahl der Pfadsegmente ein.
Zuletzt wird für jedes Segment geprüft, ob es eine Variable ist. Die Regel ist einfach: Besteht ein Segment nur aus Ziffern oder ist es länger als acht Zeichen (also neun oder mehr), wird es durch eine Variable ersetzt; andernfalls bleibt es unverändert. Im Beispiel wird nur 948213 zur Variable, weil es rein numerisch ist. products und reviews bleiben erhalten.
Mit unserem URL-Pfadsegment-Parser können Sie das direkt überprüfen.
Fügen Sie eine URL ein, und der URL-Pfadsegment-Parser berechnet sofort Pfadsegmente, Query und die Routenmuster für Express und Next.js. Kostenlos, ohne Installation und ohne Anmeldung.

Häufige Missverständnisse beim Lesen des Ergebnisses
Am häufigsten werden Query-Parameter fälschlich als Pfadsegmente gezählt. ?sort=recent ist kein Segment, sondern landet separat in der Query-Tabelle. Auf den Index /2 folgt deshalb kein /3.
Das zweite Missverständnis ist die Annahme, ein abschließender Schrägstrich verschiebe den Index um eine Stelle. Da leere Teile herausgefiltert werden, liefern /reviews und /reviews/ dasselbe Segmentergebnis.
Drittens erwarten manche, dass jeder Wert, der wie eine ID aussieht, zur Variable wird. Die Prüfung berücksichtigt aber nicht die Bedeutung des Werts, sondern nur seine Form (rein numerisch oder nicht, Länge). Eine kurze Zeichenketten-ID wie abc bleibt daher unverändert. Bei Bedarf können Sie im Feld für den Variablennamen selbst einen Namen eintragen und das Segment so in eine Variable umwandeln.
Wie dasselbe Segment in beiden Frameworks notiert wird, zeigt die folgende Tabelle am Standardbeispiel des Tools, https://example.com/users/123/posts/abc:
| Segment (Index) | Einstufung | Express.js | Next.js App Router |
|---|---|---|---|
users (/0) | Zeichenkette, höchstens acht Zeichen | users | users |
123 (/1) | nur Ziffern | :param1 | [param1] |
posts (/2) | Zeichenkette, höchstens acht Zeichen | posts | posts |
abc (/3) | Zeichenkette, höchstens acht Zeichen | abc | abc |
Die fertige Route lautet damit in Express /users/:param1/posts/abc und im Next.js App Router app/users/[param1]/posts/abc/page.tsx.
Der Standardname der Variablen ergibt sich automatisch aus dem Index, etwa param0 oder param1. Solange Sie den Namen nicht ändern, erscheint :param1 und nicht :userId. Tragen Sie im Feld einen eigenen Namen ein, wechselt die Ausgabe gleichzeitig zu :userId (Express) und [userId] (Next.js). Ein Segment mit neun oder mehr Zeichen wie introduction wird auch dann zur Variable, wenn es nicht numerisch ist, weil es die Längenbedingung erfüllt.
Zusammenfassung
- Eine URL besteht aus Protokoll, Host, Pfad und Query. Nur die an den Schrägstrichen getrennten Pfadteile erhalten einen Index (/0, /1 …).
- Die Query nach dem
?wird nicht als Pfadsegment, sondern als eigenes Schlüssel-Wert-Paar gelesen und zählt nicht zur Segmentanzahl. - Leere Teile durch aufeinanderfolgende oder abschließende Schrägstriche werden automatisch herausgefiltert, sodass sich die Indizes nicht verschieben.
- Ein Segment wird durch eine Variable ersetzt, wenn es nur aus Ziffern besteht oder neun oder mehr Zeichen hat; alle übrigen bleiben unverändert. Tragen Sie selbst einen Namen ein, wird das Segment unabhängig von der Bedingung zur Variable.
- Dasselbe Segment wird in Express als
:variableund im Next.js App Router als Ordner[variable]notiert.
Fügen Sie eine URL ein, und der URL-Pfadsegment-Parser berechnet sofort Pfadsegmente, Query und die Routenmuster für Express und Next.js. Kostenlos, ohne Installation und ohne Anmeldung.
Häufig gestellte Fragen
Zählen Query-Parameter (nach dem ?) auch als Pfadsegmente?
Nein. Die Query nach dem ? gehört nicht zum Pfad, sondern ist ein Query-String und damit kein Segment, das durch Schrägstriche getrennt wird. Sie wird separat über searchParams gelesen und als Schlüssel-Wert-Tabelle angezeigt. Sie schließt sich nicht an die Indizes der Pfadsegmente (/0, /1 …) an.
Verschiebt ein abschließender Schrägstrich den Segmentindex um eins?
Nein. Der Pfad wird an den Schrägstrichen geteilt und leere Zeichenketten werden anschließend herausgefiltert. Leere Teile durch einen Schrägstrich am Ende oder durch aufeinanderfolgende Schrägstriche in der Mitte verschwinden daher. /a/b/, /a/b und /a//b liefern deshalb jeweils dieselben Segmente.
Nach welchem Kriterium wird ein Segment zur Variable und ein anderes nicht?
Trifft eine von zwei Bedingungen zu, wird das Segment durch eine Variable ersetzt: Es besteht nur aus Ziffern, oder es ist länger als acht Zeichen (also neun oder mehr). Die Prüfung berücksichtigt nicht die Bedeutung des Werts, sondern nur seine Form. Auch wenn keine Bedingung zutrifft, wird das Segment zur Variable, sobald Sie im Feld für den Variablennamen selbst einen Namen eintragen.
Kann ich auch nur den Pfad ohne Protokoll (http/https) eingeben?
Ja. Eingaben, die nicht mit https:// beginnen, werden mit einem temporären Host geparst. Auch ein reiner Pfad wie /users/123/posts/abc wird daher in Segmente zerlegt. Sonderfälle, bei denen das Standard-Parsing fehlschlägt, werden über einen Fallback behandelt, der die Eingabe manuell an ? und / trennt.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen