Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje