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

CKTIS / JavaScript

URLSearchParams.set(): задаване на параметър на заявка

URLSearchParams.set() задава една стойност на параметър и премахва дубликатите му или добавя липсващото име.

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

Синтаксис

params.set(name, value)

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

Методът заменя стойността на първия съвпадащ запис, като запазва позицията му, и премахва останалите записи със същото име. Ако името липсва, го добавя в края. За разлика от него, append() запазва дубликатите.

Подай неенкодиран текст. При сериализация интервалите стават +, а буквалните знаци + — %2B. Извикването на url.searchParams.set() актуализира свързания обект URL.

Този Web API е част от WHATWG URL Standard, а не от конкретно издание на ECMAScript. Провери наличността в целевата среда; Node 24 не доказва поддръжка в браузърите.

Примери

const params = new URLSearchParams('q=old&page=1&q=extra');
const result = params.set('q', 'a+b c');
params.set('lang', 'pl');
console.log(params.toString());
console.log(result === undefined);

Резултат

q=a%2Bb+c&page=1&lang=pl
true

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

Източници