CKTIS / JavaScript
URLSearchParams.set(): nastavení parametru dotazu
URLSearchParams.set() přiřadí parametru jednu hodnotu a odstraní jeho duplicity, případně přidá dosud chybějící název.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
params.set(name, value)params.set(name, value) mění objekt a vrací undefined, takže volání nelze řetězit. Oba argumenty jsou povinné a převádějí se na řetězce.
Metoda nahradí hodnotu první odpovídající položky a zachová její pozici; ostatní položky se stejným názvem odstraní. Pokud název chybí, přidá ho na konec. Naproti tomu append() duplicity zachovává.
Předávejte neenkódovaný text. Při serializaci se mezery změní na + a doslovné znaky + na %2B. Volání url.searchParams.set() aktualizuje související objekt URL.
Toto Web API je součástí WHATWG URL Standard, nikoli konkrétní edice ECMAScriptu. Dostupnost ověřte v cílovém prostředí; Node 24 nedokládá podporu v prohlížečích.
Příklady
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);Výsledek
q=a%2Bb+c&page=1&lang=pl true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.