Создание сайтов · IT-курсы · 4 мин чтения
Как передать поиск в адресе страницы через URLSearchParams?
Редакция Алгоса · Обновлено
Короткий ответ
URLSearchParams помогает читать и собирать параметры после знака вопроса в адресе страницы. Он кодирует специальные символы внутри значений, поэтому поисковая фраза с пробелом или & не ломает структуру адреса. Параметры URL — открытая часть ссылки: их можно скопировать, увидеть в истории и передать другому человеку, поэтому секреты туда не помещают.
Как это устроено
Параметры состоят из имён и значений, например q=python и page=2. Между парами стоит &, поэтому этот же символ внутри поисковой фразы требует специальной записи. Ручное добавление строки пользователя после "?q=" может случайно превратить часть фразы в отдельный параметр. Готовый инструмент различает структуру и содержимое.
| Метод | Назначение |
|---|---|
| set | Установить одно значение ключа |
| append | Добавить ещё одно значение |
| getAll | Получить все значения ключа |
Разберём на примере
Для учебного поиска хотим сохранить фразу «кот & пёс». Создадим набор параметров и запишем её как одно значение q. В адресе появятся закодированные символы; при чтении get восстановит исходную строку. Вид кода в адресной строке не означает порчу русского текста.
const params = new URLSearchParams(); params.set("q", "кот & пёс"); const address = "/search/?" + params.toString(). Для чтения текущей страницы используй const incoming = new URLSearchParams(window.location.search); const query = incoming.get("q") ?? "". Отсутствие q даёт пустую строку в нашем примере.
Почему так
Метод set заменяет значение выбранного ключа и удаляет его дополнительные повторения. append добавляет ещё одно значение, а getAll возвращает все значения ключа. Это полезно для нескольких тегов. URLSearchParams сам по себе не переводит страницу по адресу и не отправляет сетевой запрос: он работает с параметрами.
Проверь себя
В строке "?tag=python&tag=web" нужно получить оба тега. Какой метод выбрать? Затем собери q со значением "a+b" и проверь обратное чтение. Почему лучше передавать исходный текст в set, а не кодировать его вручную заранее?
Ответ и объяснение
getAll("tag") вернёт ["python", "web"], а get("tag") только первое значение. Символ + внутри значения будет корректно сохранён при сборке через set и обратном разборе. Предварительное кодирование может привести к повторному кодированию. Валидацию номера страницы и допустимых тегов всё равно выполняет твой код отдельно.
Что запомнить
Передавай исходные значения в URLSearchParams; не склеивай пользовательский текст с синтаксисом адреса вручную.
Попробовать на Алгосе
Создание сайтов
Курс помогает освоить HTML/CSS и первые обработчики событий JavaScript. Отправка на настоящий сервер выходит за рамки этого примера.
Перейти к курсу Все курсы