Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła