URL
Разбирает адрес на части и собирает его обратно.
Доступно с: Web API
Синтаксис
new URL(url, base)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| url | string | Адрес — полный или относительный. |
| base | string | Необязательный. Базовый адрес для относительного url. |
Возвращаемое значение
URLОбъект с частями адреса: protocol, hostname, pathname, searchParams и другими.
Примеры
Части адреса:
const url = new URL('https://shop.example.com:8080/catalog/tea?page=2#reviews');
console.log(url.hostname);
console.log(url.pathname);
console.log(url.searchParams.get('page'));
console.log(url.hash);Результат:
shop.example.com
/catalog/tea
2
#reviewsИзменение параметров:
const url = new URL('https://example.com/search');
url.searchParams.set('q', 'green tea');
url.searchParams.set('sort', 'price');
console.log(url.href);Результат:
https://example.com/search?q=green+tea&sort=priceОтносительный адрес и проверка корректности:
console.log(new URL('../img/logo.png', 'https://example.com/blog/post/').href);
console.log(URL.canParse('not a url'));Результат:
https://example.com/blog/img/logo.png
falseПримечания
Некорректный адрес в new URL() вызывает TypeError. Проверить заранее можно через URL.canParse().
См. также
- URLSearchParams — Читает и собирает параметры адреса (часть после ?).
- encodeURIComponent — Кодирует текст для безопасной вставки в часть URL.
- fetch — Отправляет HTTP-запрос и возвращает промис ответа.
Вопросы и ответы по теме
В учебнике
- Запросы к серверу: fetch — Функция fetch в JavaScript: GET- и POST-запросы, объект ответа, статус, response.ok, разбор JSON и обработка ошибок.