Создание сайтов · 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. Отправка на настоящий сервер выходит за рамки этого примера.

Перейти к курсу Все курсы

Источники и материалы

Разобраться дальше

Все вопросы и разборы