Урок 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 руками.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.