CKTIS / JavaScript
URLSearchParams.append(): přidávání parametrů dotazu
append(name, value) přidá dvojici na konec parametrů dotazu a zachová dřívější hodnoty se stejným názvem.
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.append(name, value)params.append(name, value) změní objekt a vrátí undefined, takže volání nelze řetězit. Oba argumenty jsou povinné.
append() zachovává duplicitní hodnoty i jejich pořadí. get() přečte první hodnotu, getAll() všechny. Naproti tomu set() nahradí první hodnotu a odstraní ostatní se stejným názvem.
Předávejte nekódovaný text. toString() používá kódování application/x-www-form-urlencoded: mezera se změní na + a doslovné + na %2B; výsledek neobsahuje ?. Volání přes url.searchParams aktualizuje související objekt URL. Toto Web API je definováno standardem URL Standard, nikoli samotným ECMAScriptem.
Příklady
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);Výsledek
tag=web&tag=JavaScript+basics ["web","JavaScript basics"] undefined
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.