CKTIS / JavaScript
URL.hash i URL.href: fragment a pełny adres URL
Używaj `hash`, aby odczytać lub zmienić fragment, a `href`, aby odczytać lub zastąpić cały adres URL. Samo `hash` nie odróżnia pustego fragmentu od jego braku.
Wersja: Current web platform; runtime support varies
Składnia
const url = new URL(input, base); // Omit base for an absolute input.
url.hash; // Fragment string
url.hash = fragment;
url.href; // Full serialized URL
url.href = absoluteUrl;hash i href to właściwości instancji URL, nie metody ani właściwości statyczne. url.hash zwraca niepusty fragment wraz z początkowym #; zwraca "", gdy fragment jest pusty lub go nie ma. url.href zwraca pełny adres po serializacji, łącznie z zapytaniem, jeśli występuje. Końcowy # w href pozwala odróżnić pusty fragment od jego braku.
Do url.hash można przypisać tekst z początkowym # lub bez niego. Wymagające tego znaki, np. spacja, są kodowane procentowo, ale odczyt nie dekoduje ich automatycznie. url.hash = "" usuwa fragment, a url.hash = "#" pozostawia pusty fragment. Fragment nie jest częścią zapytania: url.searchParams dotyczy parametrów zapytania, a fragment nie jest automatycznie wysyłany do serwera w żądaniu HTTP.
Przypisanie do url.href ponownie parsuje i zastępuje cały adres w tej samej instancji. Jeśli parsowanie się nie powiedzie, zgłaszany jest TypeError. Setter nie rozwiązuje odwołań względnych względem bieżącego adresu; w tym celu użyj new URL(relative, base).href z prawidłową bazą.
Zmiana obiektu URL nie powoduje nawigacji, w przeciwieństwie do przypisania do window.location.href. Zanim użyjesz niezaufanego adresu do nawigacji, sprawdź, czy jego schemat i origin są dozwolone: samo parsowanie nie gwarantuje bezpieczeństwa. URL to API platformy webowej, a nie część ECMAScript 2024; dostępność zależy od środowiska wykonawczego.
Przykłady
{
const url = new URL("https://example.com/guide?lang=en");
const show = () => console.log(JSON.stringify([url.hash, url.href]));
url.hash = "quick start";
show();
url.hash = "#";
show();
url.hash = "";
show();
url.href = "https://example.org/start#intro";
show();
}Wynik
["#quick%20start","https://example.com/guide?lang=en#quick%20start"] ["","https://example.com/guide?lang=en#"] ["","https://example.com/guide?lang=en"] ["#intro","https://example.org/start#intro"]
Każdy wiersz pokazuje `[hash, href]`. Zwróć uwagę na `%20`, końcowy `#` tylko w drugim wierszu oraz zastąpienie całego adresu w ostatnim wierszu.
Powiązane lekcje
- JavaScript · Lekcja 30 · Zaawansowany · Wersja: 4