CKTIS / JavaScript
URLSearchParams.prototype.toString — Abfrageparameter serialisieren
Der Aufruf `params.toString()` gibt die Abfrageparameter als Text ohne vorangestelltes `?` zurück. Die Methode verwendet Formularkodierung und erhält dabei die Reihenfolge und wiederholte Namen.
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
params.toString()URLSearchParams.prototype.toString ist die Instanzmethode, die Abfrageparameter serialisiert. Rufe sie ohne Argumente als params.toString() auf. Die Eigenschaft URLSearchParams.toString am Konstruktor verweist dagegen auf die geerbte Methode Function.prototype.toString, die keine Parameter serialisiert.
Die Instanzmethode gibt den Parametertext ohne vorangestelltes ? zurück, nicht die vollständige URL. Eine leere Liste ergibt "".
Die Serialisierung verwendet application/x-www-form-urlencoded und UTF-8: Ein Leerzeichen wird zu +, ein wörtliches + zu %2B. Übergib nicht kodierte Werte, damit % nicht erneut kodiert wird.
Paare werden mit &, Namen und Werte mit = verbunden. Reihenfolge und wiederholte Namen bleiben erhalten; ein leerer Wert ergibt name=. Die Methode sortiert oder verändert die Parameter nicht. Dies ist eine Web-API aus dem URL Standard und keine durch ECMAScript definierte Funktion.
Beispiele
const params = new URLSearchParams([
["q", "a b+c"],
["tag", "js"],
["tag", "web"],
["empty", ""]
]);
console.log(params.toString());
console.log(JSON.stringify(new URLSearchParams().toString()));Ergebnis
q=a+b%2Bc&tag=js&tag=web&empty= ""
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.