База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

URLSearchParams.append(): добавяне на параметри на заявката

append(name, value) добавя двойка в края на параметрите на заявката, като запазва предишните стойности със същото име.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

params.append(name, value)

params.append(name, value) променя обекта и връща undefined, затова извикванията не могат да се свързват във верига. И двата аргумента са задължителни.

append() запазва дубликатите и реда. get() прочита първата стойност, а getAll() — всички стойности. За разлика от тях set() заменя първата стойност и премахва останалите със същото име.

Подайте некодиран текст. toString() използва кодирането application/x-www-form-urlencoded: интервалът става +, а буквалният + става %2B; резултатът не включва ?. Извикване чрез url.searchParams актуализира свързания обект URL. Този Web API е определен от URL Standard, а не от самия ECMAScript.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници