Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

URL.pathname — odczyt i zmiana ścieżki

URL.pathname pozwala odczytać lub zastąpić ścieżkę adresu URL bez zmiany jego zapytania i fragmentu.

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

url.pathname
url.pathname = path

URL.pathname to właściwość instancji URL, nie właściwość statyczna konstruktora. Zwraca zserializowaną ścieżkę bez zapytania i fragmentu. Dla adresu HTTPS bez segmentów ścieżki zwraca /.

Przypisanie zastępuje ścieżkę, zachowując search i hash. Spacje są kodowane jako %20; odczyt nie dekoduje automatycznie sekwencji procentowych. Zmiana obiektu nie powoduje nawigacji przeglądarki.

Ścieżki nieprzezroczyste, np. w mailto:person@example.org, można odczytać, ale przypisanie do pathname jest ignorowane.

Przykłady

const url = new URL('https://example.org/docs/start?q=1#intro');
console.log(url.pathname);
url.pathname = '/learn JavaScript';
console.log(url.pathname);
console.log(url.href);

Wynik

/docs/start
/learn%20JavaScript
https://example.org/learn%20JavaScript?q=1#intro

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła