URL-Query-String als Schlüssel-Wert-Objekt auslesen

Er dekodiert Prozentsequenzen und Pluszeichen aus Formularen, bewahrt leere Werte und fasst wiederholte Parameter in ihrer ursprünglichen Reihenfolge zu Listen zusammen. Fehlerhafte Escape-Sequenzen und ungültiges UTF-8 führen zu einer eindeutigen Fehlermeldung, statt Zeichen unbemerkt zu ersetzen. Sie können einen Link direkt im Browser untersuchen oder die deterministische API für $0.002 pro Element in Anwendungen, Tests und Importabläufen aufrufen, die stets dasselbe Ergebnis benötigen.

Wählen Sie die passende Eingabeform für Ihre Quelle

Sie können eine vollständige absolute URL wie <code>https://example.com/search?q=red+shoes</code>, einen rohen Query-String wie <code>q=red+shoes&amp;page=2</code> oder denselben Query-String mit einem vorangestellten Fragezeichen übergeben. Bei einer absoluten URL wird ausschließlich der Abfrageteil ausgewertet; Schema, Autorität, Pfad und Fragment werden nicht zu Feldern. Eine URL ohne Abfrage ergibt ein leeres Parameterobjekt. Eine rohe Eingabe gilt nach dem Entfernen eines optionalen anfänglichen Fragezeichens vollständig als Abfragedaten. Das ist praktisch, wenn ein Framework, ein Zugriffsprotokoll, ein Webhook oder eine Browser-API die Abfrage bereits von der übrigen Adresse getrennt hat. Jedes kaufmännische Und beginnt ein neues Paar, während das erste Gleichheitszeichen den Namen vom Wert trennt. Ein Name ohne Gleichheitszeichen bleibt mit einem leeren Wert erhalten, ebenso eine ausdrücklich leere Zuweisung. Leere Abschnitte zwischen aufeinanderfolgenden Trennzeichen werden ignoriert. Das Ergebnis nennt außerdem die Anzahl unterschiedlicher Schlüssel und ausgewerteter Paare. So erkennen Sie Wiederholungen, ohne die Eigenschaften des Objekts selbst erneut zählen zu müssen.

Verstehen Sie Dekodierung und wiederholte Schlüssel

Namen und Werte werden getrennt nach den üblichen Regeln für Formulardaten in URL-Abfragen dekodiert. Ein Pluszeichen wird zu einem Leerzeichen, während Folgen der Form <code>%HH</code> als UTF-8-Bytes interpretiert werden. Dadurch entsteht aus <code>city=San+Jos%C3%A9</code> lesbarer Unicode-Text, und ein als <code>%26</code> kodiertes Trennzeichen bleibt Bestandteil eines einzelnen Werts, statt fälschlich ein weiteres Feld zu beginnen. Die Dekodierung erfolgt genau einmal: <code>%2520</code> wird zu <code>%20</code> und nicht zu einem Leerzeichen. Kommt ein Schlüssel einmal vor, ist sein Wert eine Zeichenfolge. Sobald derselbe dekodierte Schlüssel erneut erscheint, wird daraus eine Liste mit allen Vorkommen in der Reihenfolge der Quelle. Damit lassen sich Kontrollkästchengruppen, Filter, Schlagwörter und andere Mehrfachauswahlen darstellen, ohne Angaben zu verlieren oder nummerierte Eigenschaften zu erfinden. Wiederholungen werden erst nach dem Dekodieren erkannt, sodass gleichwertige kodierte Schreibweisen desselben Namens zusammengeführt werden. Auch wiederholte leere Werte bleiben erhalten. Der Parser leitet weder boolesche Werte, Zahlen oder Datumsangaben ab noch deutet er eine Klammerschreibweise als verschachtelte Objekte. Alle Einzelwerte bleiben Zeichenfolgen, damit nachgelagerter Code bewusst die fachlich richtige Umwandlung vornehmen kann.

Stoppen Sie beschädigte Daten vor der Weiterverarbeitung

Großzügige Parser behalten mitunter ein einzelnes Prozentzeichen bei, akzeptieren einstellige Escape-Folgen oder setzen ein Ersatzzeichen ein, wenn die kodierten Bytes kein gültiges UTF-8 ergeben. Beschädigte Kennungen wirken dadurch verwendbar, und zwischen Browser, Server sowie einer Signaturprüfung entstehen schwer nachvollziehbare Unterschiede. Diese Funktion verlangt nach jedem Prozentzeichen genau zwei Hexadezimalziffern und prüft anschließend, ob jede dekodierte Bytefolge gültiges UTF-8 bildet. Schlägt eine Prüfung fehl, liefert die Anfrage einen Fehler für ungültige Eingaben und kein unvollständiges Objekt. Der Parser arbeitet rein und deterministisch: Er greift nicht auf das Netzwerk zu, folgt keiner Weiterleitung, liest keine Uhr, verwendet keinen Zufall und bewahrt zwischen Aufrufen keinen Zustand. Behandeln Sie zurückgegebene Zeichenfolgen als Daten und nicht als vertrauenswürdiges HTML, Programmcode, Dateipfade oder Datenbankausdrücke. Das Dekodieren stellt Zeichen wieder her, macht deren spätere Verwendung jedoch nicht automatisch sicher. In automatisierten Abläufen kostet die API $0.002 pro Element und dient als stabiler Normalisierungsschritt vor Prüfung, Weiterleitung, Vergleich oder Speicherung. Im Browser untersuchen Sie kopierte Links mit derselben Logik, ohne deren Ziel aufzurufen.