Как получить параметр URL в Express: исправление кода

Быстрый ответ

Для извлечения параметров URL в Express, воспользуйтесь объектом req.params. Для получения параметров строки запроса применяется req.query. Взгляните на пример:

app.get('/user/:id', function (req, res) {
  res.send(`UserID: ${req.params.id}, Фильтр: ${req.query.filter}`);
});

Так программно созданный маршрут будет ожидать параметр URL (:id) и дополнительный параметр строки запроса (filter). Вызов по адресу /user/123?filter=admin позволит извлечь значения id и filter.

Параметры маршрута: Динамизация значений в URL

Express способен обрабатывать динамические части URL через параметры маршрутов. Например, при наличии маршрута /product/:id вы сможете извлечь значение id, обратившись к req.params.id.

app.get('/product/:id', function (req, res) {
  // Получаем ID продукта
  const productId = req.params.id;
});

При этом обязательно точное соответствие имени параметра в маршруте (например, :id) и свойству объекта req.params.

Параметры запроса: Анализ URL

Параметры запроса, часто применяемые для фильтрации, сортировки или пагинации, передаются после знака вопроса "?" и доступны через объект req.query:

app.get('/search', function (req, res) {
  const queryTerm = req.query.term;  // Запрашиваемый параметр
  const sortBy = req.query.sort;     // Сортируем результаты поиска
});

Строка запроса может содержать несколько таких параметров, разделённых амперсандом "&": /search?term=nodejs&sort=latest.

Визуализация

Чтобы лучше понять процесс получения параметров URL в Express, представьте, что Express – это информационная служба в здании. Вы называете номер комнаты (параметр маршрута), чтобы найти нужный офис (маршрут).

Запрос:

GET /office/:room

🏢: {
   '/office/:room': function(req) {
      // Добро пожаловать в комнату вы задаёте
      Номер комнаты: `req.params.room`
   }
}

Чтобы попасть в комнату 42, запрос будет:

GET /office/42

Вы получите:
Номер комнаты: 42

Таким образом, Express подобно внимательному информатору с помощью req.params помогает вам найти нужную "комнату".

Управляя параметрами URL: Уроки библиотеки маршрутизации Express

Точка отладки: Определение маршрута и параметров

Если параметр не появляется там, где вы его ожидали, стоит проверить корректность определения маршрутов. Имена параметров должны совпадать как в URL, так и в соответствующих обработчиках.

Подробнее об этом расскажет наш спикер на видео

Настройка путей

Проверьте настройки путей ваших маршрутов в Express, так как ошибки в них могут препятствовать корректному извлечению параметров.

Версии Express: Выбор подходящего руководства

Обязательно используйте соответствующую версию Express, так как некоторые методы, например, req.param, устарели в новых версиях framework'а.

Власть над всем: Промежуточное ПО

Применение промежуточного ПО (middleware) с app.param() позволяет проводить преобразование или валидацию параметров, прежде чем они попадут в маршрут.

Пример использования промежуточного ПО для обработки идентификатора пользователя:

app.param('userId', function (req, res, next, id) {
  req.userId = id;
  next();
});

app.get('/user/:userId', function (req, res) {
  res.send(`Обработанный UserID: ${req.userId}`);
});

Таким образом, вы обеспечиваете единообразную обработку пользователя во всех маршрутах с :userId.

Готовимся к тестам и экспериментам

Анализируем действие: Симуляция запросов

Проводите тесты с различными URL для проверки корректной работы req.params и req.query.

Совет от знатока: Внимание к синтаксису

Учтите, что свойства req.query и req.params чувствительны к регистру и должны быть указаны в точности.

Выстреливая из промежуточного ПО: Стремимся к точности

Для анализа и логирования параметров запросов используйте промежуточное ПО, например, body-parser. Это облегчит отладку.

Полезные материалы

1. Express 4.x – Справочник API — основной источник информации о работе с параметрами в Express.
2. Express 4.x – Справочник API — подробное описание использования req.query в Express.
3. URLSearchParams – Web API | MDN — информация о интерфейсе URLSearchParams для запросов.
4. Использование промежуточного ПО в Express — руководство по работе с промежуточным ПО в Express.
5. Документация Node.js v21.6.1 — документация по модулю URL в Node.js.
6. GitHub – ljharb/qs: Парсер строки запроса — полезная библиотека для анализа сложных строк запросов.