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

CKTIS / JavaScript

URL.searchParams — параметри на заявката

URL.searchParams предоставя параметрите на заявката като обект URLSearchParams, свързан с URL адреса.

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

Синтаксис

url.searchParams

URL.searchParams е свойство на екземпляр на URL, а не статичен метод. Свойството е само за четене, но върнатият обект URLSearchParams може да се променя. Промените актуализират URL адреса; повторните прочитания връщат същия обект.

get() връща първата стойност или null; getAll() обработва повтарящи се имена. set() заменя стойностите на дадено име с една стойност.

Сериализацията използва application/x-www-form-urlencoded: интервалът става +. Това е уеб API на WHATWG, а не функционалност на издание на ECMAScript; съвместимостта с браузърите трябва да се провери отделно.

Примери

const url = new URL('https://example.com/?tag=js&tag=web');
const params = url.searchParams;
console.log(params.getAll('tag').join(','));
params.set('tag', 'api');
params.set('q', 'hello world');
console.log(url.href);

Резултат

js,web
https://example.com/?tag=api&q=hello+world

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

Източници