Query-String-Array-Parameter: Warum Sprachen sie verschieden lesen

VeröffentlichtToolURL-Parser & Query-String-Umwandlung

Inhalt
  1. Das Problem
  2. Die Lösung
  3. Typische Stolperstellen
  4. Fazit
  5. Häufige Fragen

Wenn in einer URL derselbe Schlüssel mehrfach vorkommt, etwa bei ?tag=a&tag=b, hängt es von der Programmiersprache und dem Framework ab, ob daraus ein Array wird oder nur der letzte Wert übrig bleibt. Deshalb kommt es häufig vor, dass der vom Frontend gesendete Query-String im Backend anders interpretiert wird und am Ende nur ein einziger Wert ankommt. In diesem Beitrag erfahren Sie, warum diese Regeln auseinandergehen und wie Sie selbst überprüfen können, wie ein Query-String tatsächlich gelesen wird.

Zusammenfassung ① Der Query-String einer URL kennt von sich aus keinen Datentyp „Array“. Ob mehrere Werte als Array gelten, ist lediglich eine Konvention der jeweiligen Sprache oder des Frameworks. ② Grob gibt es zwei Varianten: den wiederholten Schlüssel (tag=a&tag=b) und die Schreibweise mit eckigen Klammern (tag[]=a&tag[]=b), bei der nur Schlüssel mit Klammern als Array erkannt werden. ③ Welche Regel gilt, sehen Sie auch ohne Blick in den Code: Wandeln Sie den Query-String einfach in JSON um.

Das Problem

Stellen Sie sich eine Filteransicht vor, in der Sie per Checkbox mehrere Tags auswählen. Der Browser sendet Werte mit gleichem Namen in der Regel wiederholt, also als tag=a&tag=b.

Erkennt der Server, der diese Anfrage erhält, nur die Schreibweise mit eckigen Klammern als Array, sieht die Sache anders aus: Ein wiederholter Schlüssel ohne Klammern wird nicht zu einem Array zusammengefasst, es bleibt nur der letzte Wert übrig.

Umgekehrt gilt: Sie haben anhand der API-Dokumentation die Form tag[]=a&tag[]=b selbst gebaut und gesendet, aber die Gegenseite behandelt nur wiederholte Schlüssel als Array. Dann wird der Schlüssel fälschlich als ein einzelner Schlüssel mit dem Namen „tag[]“ gelesen.

Solche Fehler fallen bei einem Test mit nur einem Wert nicht auf. Sie treten erst auf, wenn derselbe Schlüssel mehrfach vorkommt, etwa bei Mehrfachauswahl oder mehreren Tags. Entsprechend schwer ist die Ursache zu finden.

Die Lösung

Zuerst sollten Sie sich klarmachen: Der Query-String einer URL kennt den Datentyp „Array“ gar nicht. Alles nach dem Fragezeichen ist nur eine Zeichenkette aus key=value-Paaren, die mit & aneinandergereiht sind. Ob daraus ein Array wird, legt die Seite fest, die den String liest – es ist eine Konvention.

Diese Konventionen lassen sich grob in zwei Gruppen einteilen. Entweder wird derselbe Schlüssel einfach wiederholt, oder es werden eckige Klammern angehängt, damit der Schlüssel als Array erkannt wird.

Wiederholter Schlüssel oder eckige Klammern

Die Standard-API des Browsers, URLSearchParams, fasst wiederholte Schlüssel nicht von selbst zu einem Array zusammen. get("tag") liefert nur den ersten Wert. Möchten Sie alle Werte erhalten, müssen Sie ausdrücklich getAll("tag") aufrufen.

Auch eckige Klammern behandelt URLSearchParams nicht gesondert. Wenn Sie tag[]=a&tag[]=b übergeben, wird nicht „tag“, sondern ein Schlüssel mit dem Namen „tag[]“ erkannt.

Sprachen und Frameworks mit der Klammer-Schreibweise verhalten sich dagegen genau umgekehrt. Wird tag=a&tag=b ohne Klammern wiederholt, entsteht kein Array, sondern es bleibt nur der letzte Wert übrig. Für ein Array müssen Sie die Form tag[]=a&tag[]=b verwenden.

Schritt für Schritt von Hand prüfen

Wenn Werte verloren gehen, gehen Sie am besten in dieser Reihenfolge vor. Prüfen Sie zuerst, ob Ihr eigener Code wiederholte Schlüssel oder eckige Klammern sendet.

Vergleichen Sie danach in der Dokumentation des Servers, welche Regel für das Parsen des Query-Strings gilt. Unterscheiden sich beide, müssen Sie entweder das Format im Client anpassen oder im Server Code ergänzen, der wiederholte Schlüssel selbst zu einem Array zusammenfasst.

Am schnellsten gelingt die Prüfung, wenn Sie einen Query-String tatsächlich eingeben und mit eigenen Augen sehen, ob daraus ein Array wird. Probieren Sie es mit unserem Tool „URL-Parser & Query-String-Umwandlung“ aus.

URL-Parser & Query-String-Umwandlung

Geben Sie eine URL oder einen Query-String ein, und Sie sehen die als Array gebündelten Parameter sofort als JSON.

Typische Stolperstellen

SituationUrsache
Mehrere Checkboxen wurden ausgewählt, aber auf dem Server kommt nur ein Wert anDer Server erkennt nur die Klammer-Schreibweise (tag[]=) als Array, der Client hat aber wiederholte Schlüssel (tag=a&tag=b) gesendet.
Mit URLSearchParams.get("tag") erhalten Sie nur einen Wertget() gibt immer nur den ersten Wert zurück. Für alle Werte benötigen Sie getAll("tag").
Ein Array aus JSON wurde in einen Query-String umgewandelt, aber der Server kann ihn nicht lesenDas Array wurde mit wiederholten Schlüsseln serialisiert, der Server erkennt aber nur die Klammer-Schreibweise als Array.
Bei derselben URL ist das Ergebnis anders, sobald Sprache oder Framework wechselnFür Arrays im Query-String gibt es keinen festen Standard, daher unterscheiden sich die Parsing-Regeln.

Fazit

Ob ein mehrfach vorkommender Schlüssel im Query-String zu einem Array zusammengefasst wird und welche Schreibweise als Array gilt, ist kein Standard, sondern Konvention der jeweiligen Sprache oder des Frameworks.

Verschwindende Werte oder nur ein einzelner übrig gebliebener Wert entstehen meist, wenn die vom Client gesendete Schreibweise und die vom Server erwartete nicht zusammenpassen. Wenn Sie nicht sicher sind, welche Konvention gilt, wandeln Sie den tatsächlichen Query-String in JSON um und sehen Sie sich das Ergebnis an. Das ist der verlässlichste Weg.

URL-Parser & Query-String-Umwandlung

Geben Sie eine URL oder einen Query-String ein, und Sie sehen die als Array gebündelten Parameter sofort als JSON.

Häufige Fragen

Wird tag[]=a&tag[]=b mit eckigen Klammern als Array erkannt?

Das Tool verwendet unverändert die Browser-Standard-API URLSearchParams und interpretiert eckige Klammern deshalb nicht gesondert. Wenn Sie tag[]=a&tag[]=b eingeben, wird nicht „tag“ angezeigt, sondern ein Schlüssel mit dem Namen „tag[]“, der zwei Werte enthält. Bei der Anbindung an ein Backend, das eckige Klammern als Array-Schreibweise nutzt, sollten Sie diesen Unterschied berücksichtigen.

Welches Format entsteht, wenn ich ein Array aus JSON in einen Query-String umwandle?

Der Tab „JSON → Query“ serialisiert Array-Werte nicht mit eckigen Klammern, sondern durch Wiederholung desselben Schlüssels. So wird zum Beispiel {"tag": ["a", "b"]} zu tag=a&tag=b. Benötigt Ihr Server die Klammer-Schreibweise, müssen Sie [] im Ergebnis selbst ergänzen.

Worin unterscheiden sich die Tabs „URL zerlegen“ und „Query → JSON“?

„URL zerlegen“ gliedert die gesamte URL auf, bis hin zu protocol, host, port, pathname und hash, und zeigt den enthaltenen Query-Teil zusätzlich als JSON an. Wenn Sie nur den Query-String nach dem Fragezeichen vorliegen haben, können Sie ihn direkt in den Tab „Query → JSON“ einfügen.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. Regex ersetzen mit $1 und $&: Gruppen richtig nutzenWie $1, $2 und $& beim Suchen und Ersetzen mit regulären Ausdrücken ersetzt werden, warum $ ohne Regex-Modus stehen bleibt und was die Ersetzungszahl zählt.
  2. Regex-Tester: Sonderzeichen und Flags prüfen, Treffer testenBedeutung von ^, $, . und * sowie der Flags g, i, m, s, u, y. So prüfen Sie Treffer und Erfassungsgruppen und vermeiden ReDoS-Muster, die den Browser blockieren.
  3. Regex: E-Mail, URL und Zahlen aus Text extrahieren – MusterFünf gängige Regex-Muster für E-Mail, URL, IP, Telefonnummer und Zahlen sowie Erfassungsgruppen, mit denen Sie nur den gewünschten Teil herausziehen.
  4. Regulären Ausdruck lesen: Bedeutung der Zeichen im ÜberblickSo lesen Sie reguläre Ausdrücke Stück für Stück: Anker, Zeichenklassen, Gruppen und Quantifizierer erklärt, plus ein Tool, das jedes Zeichen automatisch erläutert.
  5. Leerzeilen entfernen: Regex /^\s*\n/gm und CRLF/LF erklärtSo löschen Sie überflüssige Leerzeilen im Text per regulärem Ausdruck oder fassen sie zusammen – inklusive Umgang mit Windows- (CRLF) und Mac-Zeilenumbrüchen (LF).
  6. Zeilenumbrüche entfernen: PDF-Text sauber zu Absätzen formenSo entfernen Sie harte Zeilenumbrüche aus kopierten PDF- und E-Mail-Texten, behalten Absätze bei und bereinigen doppelte Leerzeichen in einem Schritt.

Passende Tools