re:re:actable
Урок 021 минута чтения

Как работать с URL и query parameters?

На этой странице
Кратко

Для разбора и сборки URL в Node.js удобно использовать стандартные классы URL и URLSearchParams. Они безопаснее ручной склейки строк и корректно кодируют query parameters.

Вопрос

Как работать с URL и query-параметрами в Node.js?

Разбор URL

const url = new URL('https://example.com/search?q=node&page=2');
 
console.log(url.origin); // https://example.com
console.log(url.pathname); // /search
console.log(url.searchParams.get('q')); // node

Сборка URL

const url = new URL('https://api.example.com/users');
 
url.searchParams.set('page', '1');
url.searchParams.set('limit', '20');
 
console.log(url.toString());

В HTTP-сервере

req.url содержит только путь и query string, поэтому для парсинга нужен base URL.

import http from 'node:http';
 
http.createServer((req, res) => {
  const url = new URL(req.url, 'http://localhost');
 
  const page = Number(url.searchParams.get('page') || 1);
 
  res.end(JSON.stringify({ page }));
}).listen(3000);

Почему не склеивать руками?

const url = `https://api.example.com/search?q=${query}`;

Если query содержит пробелы, & или ?, строка может сломаться. URLSearchParams кодирует такие значения корректно.

Что важно помнить

  • new URL(input, base) парсит URL; для req.url нужна база: new URL(req.url, 'http://localhost').
  • url.searchParams — URLSearchParams: get, getAll, set, append.
  • Значения кодируются автоматически — не склеивайте query строками вручную.
  • URL.canParse() проверяет строку без try/catch.

Мини-шпаргалка

  • new URL(value) парсит абсолютный URL.
  • Для req.url нужен base URL.
  • url.searchParams.get(name) читает query.
  • url.searchParams.set(name, value) задает query.
  • Не склеивай query string руками.

Документация

Node.js: URL, MDN: URLSearchParams.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам