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

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.

Zdroje