Alle Ratgeber

Struktur und Parsing von Query-Strings

Ratgeber zur URL-Kodierung

Ein Query-String ist der Teil einer URL nach ?, der einer Seite zusätzliche Informationen übergibt. In https://example.com/search?q=book&page=2 ist der Query-String q=book&page=2.

Die Regeln

Ein Query-String besteht aus key=value-Paaren, die mit & verbunden sind.

Wenn ein Wert Sonderzeichen enthält

Enthält ein Wert & oder =, kollidiert er mit den Trennern, daher muss der Wert mit encodeURIComponent kodiert werden. Ein Suchbegriff a&b muss als q=a%26b geschrieben werden, damit der Parameter intakt bleibt. Ein Leerzeichen wird je nach Kodierung als %20 oder + dargestellt, und Parser machen aus + oft wieder ein Leerzeichen.

Sicheres Parsing

Browser liefern URLSearchParams mit, um Query-Strings sicher zu handhaben. Darauf zurückzugreifen, statt selbst an & zu trennen, erledigt Kodierung, doppelte Schlüssel und leere Werte automatisch.

Der Query-Parser-Tab dieser Seite zerlegt eine eingefügte URL in Komponenten und zeigt den Rohwert und den dekodierten Wert jedes Parameters nebeneinander an.