CKTIS / JavaScript
URL — parsowanie i modyfikowanie adresów
URL rozkłada adres na składniki, rozwiązuje odwołania względne i pozwala modyfikować parametry zapytania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new URL(url, base?)URL to API standardu WHATWG, nie ECMAScript. new URL(url, base?) parsuje adres; odwołania względne wymagają bazy. Niepowodzenie parsowania powoduje TypeError.
href udostępnia pełny zserializowany adres, a pathname — ścieżkę. Dla HTTP(S) origin obejmuje schemat, host i ewentualny port, bez ścieżki. Rozwiązywanie względem bazy nie jest konkatenacją: końcowy / ma znaczenie.
searchParams jest powiązanym obiektem URLSearchParams: jego modyfikacje aktualizują adres. Wartości przekazuj bez wcześniejszego kodowania; spacje są serializowane jako +. Poprawne parsowanie nie oznacza bezpiecznego adresu — sprawdzaj dozwolone protocol i origin.
Przykłady
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Wynik
/app/items https://example.com/app/items?q=red+shoes
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.