Ratgeber: Mit URLSearchParams mehrfach vorkommende Filterwerte erhalten

Ein Filtername kann mehrere Werte besitzen

Eine Suchseite erlaubt mehrere Farben. In ihrer Adresse steht derselbe Parametername deshalb wiederholt, einmal für Blau und einmal für Grün. Beim Wiederöffnen wird jedoch nur eine Farbe ausgewählt. Für diese Situation beschreibt MDN die Methode getAll von URLSearchParams: Sie liefert alle zum Namen gehörenden Werte als Array. Die technische Möglichkeit ersetzt noch nicht die fachliche Frage, ob mehrere Farben gemeinsam oder alternativ gemeint sind.

Mehrfachauswahl als eigene Regel planen

Lege fest, welche Filter mehrfach vorkommen dürfen. Eine Farbe kann mehrere Auswahlwerte haben, während eine einzelne Sortierreihenfolge möglicherweise eindeutig bleiben soll. Notiere außerdem, wie unbekannte oder doppelte Werte behandelt werden. Eine Adresse ist eine Eingabe und keine automatische Freigabe beliebiger Datenbankbedingungen. Im Backend müssen dieselben erlaubten Werte und ihre Bedeutung geprüft werden.

Für eine kleine Probe genügt eine künstliche Liste aus farbigen Musterkarten. Wähle zwei Werte, kopiere die erzeugte Adresse und öffne sie erneut. Die sichtbaren Auswahlfelder und die angezeigten Treffer sollten denselben Zusammenhang zeigen. Eine vollständig gelesene Parameterliste beweist noch nicht, dass die Abfrage diese Liste auch richtig verarbeitet hat. Beide Seiten des Ablaufs gehören deshalb in die Abnahme.

Leere und unerwartete Werte berücksichtigen

Teste zusätzlich eine Adresse ohne den Filter, mit einem leeren Wert und mit einem unbekannten Eintrag. Die Dokumentation erklärt, dass getAll bei fehlendem Namen auch ein leeres Array liefern kann. Deine Anwendung muss daraus eine passende Entscheidung ableiten. Keine Auswahl könnte etwa alle erlaubten Farben bedeuten. Das ist eine Projektregel und keine eingebaute Aussage der URL-Methode.

Eine teilbare Ansicht erhalten

Kontrolliere nach Änderungen an der Suche, ob die Adresse weiterhin denselben Zustand beschreibt. Zurücknavigation und ein erneut geöffneter Link dürfen nicht still eine andere Auswahl zeigen. Halte den konkreten Mehrfachfall als kleinen Regressionstest fest. Die Methode hilft beim vollständigen Lesen der Werte. Eine verständliche Suche entsteht erst, wenn Anzeige, Abfrage und teilbarer Link dieselbe vereinbarte Bedeutung bewahren.