WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URLSearchParams.set(): einen Abfrageparameter festlegen

URLSearchParams.set() weist einem Parameter einen Wert zu und entfernt dabei Duplikate oder fügt einen noch nicht vorhandenen Namen hinzu.

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.set(name, value)

params.set(name, value) verändert das Objekt und gibt undefined zurück; Aufrufe lassen sich daher nicht verketten. Beide Argumente sind erforderlich und werden in Zeichenfolgen umgewandelt.

Die Methode ersetzt den Wert des ersten passenden Eintrags, wobei dessen Position erhalten bleibt, und entfernt weitere Einträge mit demselben Namen. Einen noch nicht vorhandenen Namen fügt sie am Ende hinzu. append() dagegen behält Duplikate bei.

Übergib nicht kodierten Text. Bei der Serialisierung werden Leerzeichen zu + und wörtliche + zu %2B. Ein Aufruf von url.searchParams.set() aktualisiert das zugehörige URL-Objekt.

Diese Web API gehört zum WHATWG URL Standard und nicht zu einer bestimmten ECMAScript-Ausgabe. Prüfe die Verfügbarkeit in der Zielumgebung; Node 24 belegt keine Browserunterstützung.

Beispiele

const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);

Ergebnis

q=a%2Bb+c&page=1&lang=pl
true

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.

Quellen