Решение проблемы req.path в Express и Node.js

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

Чтобы извлечь путь клиентского запроса в Express, следует воспользоваться свойством req.path. Это свойство отделяет pathname из URL запроса, игнорируя при этом строку запроса (query string).

Приведем пример:

app.get('*', (req, res) => {
  console.log(req.path);  // Отобразит: "/example", игнорируя "/example?filtering=Nn4KDw"
});

В данном случае выводится только та часть URL, которая относится к маршруту — /example, без учета параметров запроса.

Если же вам нужен полный URL-адрес со всеми его составляющими, используйте req.originalUrl, как показано в примере ниже:

app.get('*', (req, res) => {
  console.log(req.originalUrl);  // Отобразит: "/example?filtering=Nn4KDw", включая строку запроса
});

Разбор объекта req

Давайте подробнее изучим свойства объекта req, чтобы максимально эффективно их применять.

Применение req.originalUrl

Свойство req.originalUrl предоставляет полный путь запроса, включая строку запроса.

app.use((req, res, next) => {
  console.log(req.originalUrl);  // Отобразит: "/example?filtering=Nn4KDw"... Таким образом, перед нами полный путь запроса
  next();
});

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

Сочетание req.baseUrl и req.path

При работе с подприложениями Express или маршрутизаторами для получения полного пути следует использовать комбинацию req.baseUrl и req.path.

app.use('/subapp', subApp);
subApp.get('/example', (req, res) => {
  console.log(req.baseUrl + req.path); // Отобразит: "/subapp/example" – это и есть полный путь в контексте подприложения
});

Аутентификация и перенаправление

В случаях с аутентификацией и перенаправлением req.originalUrl нужно для сохранения строки запроса, что позволяет пользователю вернуться на желаемый маршрут после входа в систему.

function authMiddleware(req, res, next) {
  if (!req.session.user) { // Клиент не прошел аутентификацию, перенаправим его на страницу входа...
    res.redirect('/login?redirect=' + encodeURIComponent(req.originalUrl)); // Сохраним маршрут пользователя
    return;
  }
  next();
}

Структура объекта req

Понимание свойств объекта req поможет усовершенствовать работу с URL:

• req.path: Путь без строки запроса.
• req.originalUrl: Полный путь запроса, включая строку запроса.
• req.url: Аналог req.originalUrl, однако может быть изменен промежуточным программным обеспечением Express.
• req.baseUrl: Базовый путь маршрута при использовании подпутей.

Современные подходы к анализу URL

ExpressJS эффективно раскрыть возможности анализа URL для маршрутизации приложений.

Получение данных о протоколе и наименовании хоста

Объект req также позволяет получить информацию о протоколе и имени хоста:

console.log(req.protocol); // Отобразит: "http" или "https", если используется шифрование
console.log(req.hostname); // Отобразит: "example.com", это идентификатор хоста запроса

Использовав эти свойства вместе с req.originalUrl, можно воссоздать полный URL запроса.

Визуализация — подробная инструкция

В качестве примера возьмем:

Терминал (🏢): [Кафе, Туалет, Duty Free, Ворота А1]

Объект Express req — это своего рода информационная служба (🔍):

🔍 req.path: Туалет
# 'req.path' укажет путь к самым востребованным местам.

Но для получения полной навигационной информации:

🔍 req.originalUrl: Туалет + кофе по пути

Здесь req.originalUrl подскажет не только местоположение, но и важные точки на маршруте!

Приспособление под сложные маршруты

С помощью объекта req вы можете гибко управлять промежуточным ПО и надежно перенаправлять запросы в условиях динамического формирования URL.

Управление модульными приложениями

Обладая знаниями об особенностях работы маршрутизаторов Express и модульных приложений, вы сможете уверенно работать с изменениями пути, которые влечет за собой обновление req.baseUrl.

Меры предосторожности при работе с устаревшими методами

В ходе освоения тонкостей методов разбора URL следует проявлять осторожность: не стоит использовать устаревшие техники, ориентируйтесь на актуализированные стандарты в Express.

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

1. Express версия 4.x – Справочник API – Руководство по req.path.
2. Stack Overflow о получении пути запроса в Express – Полезные дискуссии и советы разработчиков.
3. MDN: Введение в Express/Node – Обширное руководство по Express и Node.js.
4. HTTP | Документация Node.js – Подробное описание объекта запроса в Node.js.
5. Руководство по маршрутизации в Express – Тщательный разбор маршрутизации в Express.
6. Блог Flavio Copes — Подробно рассказывается об Express.js, включая req.params, req.query и req.body.
7. Youtube: Курс Node.js — Express-приложения – Видеоурок о работе с объектами запроса и ответа в Express.