Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła