CKTIS / JavaScript
URLSearchParams.append(): Abfrageparameter hinzufügen
append(name, value) fügt am Ende der Abfrageparameter ein Wertepaar hinzu und erhält dabei frühere Werte mit demselben 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.append(name, value)params.append(name, value) verändert das Objekt und gibt undefined zurück; Aufrufe lassen sich daher nicht verketten. Beide Argumente sind erforderlich.
append() erhält Duplikate und die Reihenfolge. get() liest den ersten Wert aus, getAll() alle Werte. Im Gegensatz dazu ersetzt set() den ersten Wert und entfernt weitere Werte mit diesem Namen.
Übergib nicht codierten Text. toString() verwendet die Codierung application/x-www-form-urlencoded: Ein Leerzeichen wird zu +, ein wörtliches + zu %2B; das Ergebnis enthält kein ?. Ein Aufruf über url.searchParams aktualisiert das zugehörige URL-Objekt. Diese Web API ist im URL Standard definiert, nicht in ECMAScript selbst.
Beispiele
const params = new URLSearchParams("tag=web");
const result = params.append("tag", "JavaScript basics");
console.log(params.toString());
console.log(JSON.stringify(params.getAll("tag")));
console.log(result);Ergebnis
tag=web&tag=JavaScript+basics ["web","JavaScript basics"] undefined
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.