CKTIS / JavaScript
URLSearchParams.append(): pridávanie parametrov dotazu
append(name, value) pridá dvojicu na koniec parametrov dotazu a zachová predchádzajúce hodnoty s rovnakým názvom.
Verzia: 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.append(name, value)params.append(name, value) zmení objekt a vráti undefined, takže volania nemožno reťaziť. Oba argumenty sú povinné.
append() zachováva duplicitné hodnoty aj ich poradie. get() prečíta prvú hodnotu a getAll() všetky. Naopak, set() nahradí prvú hodnotu a odstráni ostatné s rovnakým názvom.
Odovzdávajte nekódovaný text. toString() používa kódovanie application/x-www-form-urlencoded: medzera sa zmení na + a doslovné + na %2B; výsledok neobsahuje ?. Volanie cez url.searchParams aktualizuje súvisiaci objekt URL. Toto Web API definuje štandard URL Standard, nie samotný ECMAScript.
Prí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ýsledok
tag=web&tag=JavaScript+basics ["web","JavaScript basics"] undefined
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.