URL-Pfadsegmente auslesen und in Routen umwandeln

VeröffentlichtToolURL-Pfadsegment-Parser

Inhalt
  1. Pfadsegmente falsch gezählt: Das Problem beim Übertragen langer URLs in Routen
  2. URL ohne Tool zerlegen: nur mit dem Browser
  3. Häufige Missverständnisse beim Lesen des Ergebnisses
  4. Zusammenfassung
  5. Häufig gestellte Fragen

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:

  1. protocol und hostname liefern zuerst das Protokoll und den Host.
  2. pathname wird 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.
  3. Die übrigen Teile werden von vorn mit 0, 1, 2 nummeriert. Das Beispiel oben ergibt also drei Segmente: products (/0), 948213 (/1) und reviews (/2).
  4. Die Query nach dem ? wird separat über searchParams als 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.

URL-Pfadsegment-Parser

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)EinstufungExpress.jsNext.js App Router
users (/0)Zeichenkette, höchstens acht Zeichenusersusers
123 (/1)nur Ziffern:param1[param1]
posts (/2)Zeichenkette, höchstens acht Zeichenpostsposts
abc (/3)Zeichenkette, höchstens acht Zeichenabcabc

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 :variable und im Next.js App Router als Ordner [variable] notiert.
URL-Pfadsegment-Parser

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

Ähnliche Artikel

  1. URL-Kodierung erklärt: Prozentkodierung und kaputte UmlauteWarum Leerzeichen und Umlaute in URLs nicht direkt stehen dürfen, wie Prozentkodierung funktioniert und worin sich encodeURI und encodeURIComponent unterscheiden.
  2. User-Agent-Header: Aufbau, Auswertung und Simulation von BotsSo ist der User-Agent-String aufgebaut, wie Sie ihn auslesen und per Regex auswerten und was Client Hints ändern. Mit Beispielen für Mobilgeräte und Crawler.
  3. CSS Grid Layout: fr-Einheit, Template Areas und responsives RasterSo gestalten Sie 2D-Layouts mit CSS Grid: fr-Einheit berechnen, grid-template-areas einsetzen und ein responsives Raster ohne Media Queries aufbauen.
  4. XML in JSON umwandeln: Warum Arrays und Attribute sich ändernWarum JSON-Arrays in XML zu wiederholten Tags werden und XML-Attribute in JSON unter @attributes landen – erklärt anhand klarer Regeln.
  5. Wohlgeformtes XML: Warum XML strenger als HTML parstBrowser reparieren HTML-Fehler, XML wird bei einem einzigen Fehler komplett abgelehnt. Die Regeln der Wohlgeformtheit und wie Sie Parsing-Fehler finden.
  6. YAML in JSON umwandeln: Regeln, Fehlerquellen, PrüfungWarum Code und API-Anfragen JSON statt YAML erwarten, wie die Umwandlung von Hand funktioniert und an welchen Stellen leicht Fehler passieren.

Passende Tools