CKTIS / JavaScript
`URL.origin`, `URL.pathname` i `URL.search`
Rozróżnij pochodzenie, ścieżkę i zapytanie przeanalizowanego adresu URL oraz odczytuj pojedyncze parametry bez ręcznego dzielenia adresu.
Wersja: Current web platform; runtime support varies
Składnia
const url = new URL(input);
const resolved = new URL(input, base);
url.origin;
url.pathname;
url.search;
url.pathname = "/catalog";
url.search = "page=2";origin, pathname i search to właściwości instancji URL, a nie metody. URL należy do platformy webowej, nie do ECMAScript 2024, więc sprawdź, czy środowisko wykonawcze go udostępnia. new URL(input) przyjmuje adres bezwzględny; dla odwołania względnego podaj odpowiednią bazę w new URL(input, base). Jeśli podana baza jest nieprawidłowa lub nie można przetworzyć adresu, konstruktor zgłasza TypeError. Zmiana obiektu URL nie powoduje nawigacji.
origin jest tylko do odczytu. Dla HTTP(S) zawiera schemat i nazwę hosta oraz port, jeśli nie jest domyślny. Nie obejmuje danych logowania, ścieżki, zapytania ani fragmentu. Nieprzezroczyste pochodzenie, np. dla adresu data:, daje napis "null", a nie wartość null. Równość dwóch takich napisów nie dowodzi wspólnego pochodzenia. Wynik dla file: zależy od implementacji.
pathname to zapisana w postaci tekstowej ścieżka bez zapytania i fragmentu. Dla HTTP(S) zaczyna się od /, a ścieżka główna to /. Sekwencje procentowe, takie jak %20, nie są automatycznie dekodowane. Ścieżkę HTTP(S) można zmienić przez przypisanie. Inne schematy mogą mieć ścieżkę nieprzezroczystą, bez początkowego /.
search zwraca zapytanie z początkowym ?, bez fragmentu i bez dekodowania sekwencji procentowych. Zwraca "", gdy zapytania nie ma lub jest puste, także przy samym ?. Nowe zapytanie można przypisać z początkowym ? lub bez niego; przypisanie "" usuwa zapytanie.
Aby odczytać zdekodowaną wartość parametru, użyj url.searchParams.get("q"). Zmiany przez searchParams aktualizują ten sam obiekt URL i mogą zmienić zapis istniejących wartości: spacja zapisana jako %20 może przyjąć postać +. Pełny adres, wraz z fragmentem, odczytasz z href.
Przykłady
{
const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
console.log(url.origin);
console.log(url.pathname);
console.log(url.search);
console.log(url.searchParams.get("q"));
url.searchParams.set("page", "2");
console.log(url.href);
}Wynik
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
Domyślny port `443` i segment `.` znikają podczas normalizacji. `search` zachowuje `%20`, `get("q")` zwraca wartość ze spacją, a dodanie `page=2` zmienia zapis tej spacji w zapytaniu na `+`.
Powiązane lekcje
- JavaScript · Lekcja 38 · Zaawansowany · Wersja: 4