URLSearchParams
Читает и собирает параметры адреса (часть после ?).
Доступно с: Web API
Синтаксис
new URLSearchParams(init)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| init | string | object | Необязательный. Строка вида a=1&b=2, объект или массив пар. |
Возвращаемое значение
URLSearchParamsОбъект с методами get, set, append, has, delete и toString.
Примеры
Чтение параметров:
const params = new URLSearchParams('?city=Berlin&page=2');
console.log(params.get('city'));
console.log(Number(params.get('page')));
console.log(params.get('missing'));Результат:
Berlin
2
nullСборка строки параметров из объекта:
const params = new URLSearchParams({ q: 'tea & cake', limit: 10 });
console.log(params.toString());Результат:
q=tea+%26+cake&limit=10Параметры в обычный объект:
const params = new URLSearchParams('a=1&b=2');
console.log(Object.fromEntries(params));Результат:
{
"a": "1",
"b": "2"
}Примечания
Значения всегда строки — числа нужно преобразовывать самим. Кодирование специальных символов выполняется автоматически, пробел записывается как +.
См. также
- URL — Разбирает адрес на части и собирает его обратно.
- encodeURIComponent — Кодирует текст для безопасной вставки в часть URL.
- Object.fromEntries — Создаёт объект из списка пар ключ — значение.
Вопросы и ответы по теме
В учебнике
- Запросы к серверу: fetch — Функция fetch в JavaScript: GET- и POST-запросы, объект ответа, статус, response.ok, разбор JSON и обработка ошибок.