URLSearchParams

Работа с query-параметрами URL.

Зачем нужно

Удобный API для чтения, создания и модификации строки параметров URL. Автоматическое кодирование/декодирование спецсимволов.

Где используется

  • Парсинг query string из URL
  • Формирование параметров для API-запросов
  • Фильтрация и пагинация через URL

Code

// Создание
const params = new URLSearchParams('page=1&sort=name');

// Из текущего URL
const current = new URLSearchParams(window.location.search);

// Чтение
params.get('page');    // "1"
params.has('sort');    // true
params.getAll('tag');  // ["js", "web"]

// Модификация
params.set('page', '2');
params.append('tag', 'js');
params.delete('sort');

// В строку
params.toString(); // "page=2&tag=js"

// Итерация
for (const [key, value] of params) {
  console.log(key, value);
}

// Совместно с URL
const url = new URL('https://api.example.com/search');
url.searchParams.set('q', 'hello world');
console.log(url.href); // автокодирование пробелов

Связанные темы

Ресурсы