Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URLSearchParams.append(): dodawanie parametrów zapytania

append(name, value) dodaje parę na końcu parametrów zapytania, zachowując wcześniejsze wartości tej samej nazwy.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

params.append(name, value)

params.append(name, value) modyfikuje obiekt i zwraca undefined, więc nie umożliwia łączenia wywołań w łańcuch. Oba argumenty są wymagane.

append() zachowuje duplikaty i kolejność. get() odczytuje pierwszą wartość, a getAll() wszystkie. Natomiast set() zastępuje pierwszą wartość i usuwa pozostałe o tej nazwie.

Przekazuj niezakodowany tekst. toString() stosuje kodowanie application/x-www-form-urlencoded: spacja staje się +, a dosłowny + — %2B; wynik nie zawiera ?. Wywołanie przez url.searchParams aktualizuje powiązany URL. To Web API określone w URL Standard, nie funkcja samego ECMAScript.

Przykłady

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);

Wynik

tag=web&tag=JavaScript+basics
["web","JavaScript basics"]
undefined

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła