CKTIS / JavaScript
URLSearchParams — Abfrageparameter
URLSearchParams liest Abfrageparameter aus und ändert sie. Dabei bleiben wiederholte Namen erhalten, und die Formular-Kodierung wird unterstützt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new URLSearchParams()
new URLSearchParams(init)
params.get(name)
params.getAll(name)
params.append(name, value)
params.set(name, value)
params.toString()URLSearchParams ist eine API des WHATWG-URL-Standards, nicht von ECMAScript. Der Konstruktor akzeptiert eine Abfrage (optional mit einem vorangestellten ?), einen Datensatz oder Name-Wert-Paare; eine vollständige URL analysiert er nicht.
get() gibt den ersten Wert oder null zurück; getAll() gibt alle Werte zurück. append() fügt ein Paar hinzu. Wenn der angegebene Name bereits vorkommt, ändert set() den Wert des ersten Paars mit diesem Namen und entfernt alle weiteren Paare mit demselben Namen. Andernfalls fügt set() am Ende ein neues Paar hinzu.
toString() lässt ? weg und verwendet application/x-www-form-urlencoded: Leerzeichen werden zu +, wörtliche Pluszeichen zu %2B. Übergib den Methoden nicht kodierte Werte.
Änderungen an url.searchParams aktualisieren die zugehörige URL und können deren Kodierung ändern. Der Standard ist keine Browser-Kompatibilitätstabelle; Node 24 belegt keine Browser-Unterstützung.
Beispiele
const params = new URLSearchParams("tag=js&tag=web");
console.log(params.getAll("tag").join(","));
params.set("tag", "api");
params.append("q", "a+b c");
console.log(params.toString());Ergebnis
js,web tag=api&q=a%2Bb+c
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.