CKTIS / JavaScript
URL — парсване и промяна на адреси
URL разделя адреса на компоненти, разрешава относителни препратки и позволява промяна на параметрите на заявката.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new URL(url, base?)URL е API на WHATWG, а не на ECMAScript. new URL(url, base?) парсва адрес; за относителните препратки е необходима базова стойност. При неуспешно парсване се хвърля TypeError.
href предоставя пълния сериализиран адрес, а pathname — пътя му. При HTTP(S) origin съдържа схемата, хоста и евентуалния порт, но не и пътя. Разрешаването спрямо базова стойност не е конкатенация: крайната / има значение.
searchParams е свързан обект URLSearchParams: промените в него актуализират адреса. Подай стойностите без предварително кодиране; интервалите се сериализират като +. Успешното парсване не означава, че адресът е безопасен — провери дали protocol и origin са разрешени.
Примери
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Резултат
/app/items https://example.com/app/items?q=red+shoes
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.