CKTIS / JavaScript
Location: fragment, pochodzenie, ścieżka, zapytanie i pełny URL
Odczytuj składniki bieżącego adresu dokumentu i odróżniaj właściwości uruchamiające nawigację od właściwości tylko do odczytu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const loc = window.location;
loc.hash; // string: fragment
loc.origin; // string: URL origin (read-only)
loc.pathname; // string: path
loc.search; // string: query
loc.href; // string: complete URL
// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";window.location udostępnia obiekt Location powiązany z dokumentem. Jest to API platformy webowej, a nie część ECMAScript 2024. Obiekt odzwierciedla bieżący URL, natomiast zapisana wcześniej wartość tekstowa nie aktualizuje się. Gdy chcesz analizować lub zmieniać kopię adresu bez nawigacji, użyj new URL(window.location.href).
href to pełny URL w postaci tekstowej. pathname to sama ścieżka, bez zapytania i fragmentu. W adresach HTTP(S) zaczyna się od /, nawet dla ścieżki głównej; ścieżka nieprzezroczysta, taka jak blank w about:blank, nie musi mieć początkowego ukośnika. search zwraca niepuste zapytanie z ?, a hash niepusty fragment z #. Gdy danego składnika nie ma lub jest pusty, wynik to "", choć sam separator może nadal występować w href. Odczyt nie dekoduje zapisu procentowego. Parametry zapytania możesz odczytać przez new URLSearchParams(window.location.search).
origin jest tylko do odczytu i opisuje pochodzenie URL-a. Dla HTTP(S) zawiera schemat i nazwę hosta, a także port, jeśli nie jest domyślny; dla nieprzezroczystego pochodzenia URL-a zwraca tekst "null", nie wartość null. Nie jest tym samym co self.origin, czyli pochodzenie środowiska wykonania: dokument about:blank może je odziedziczyć. Zgodność napisów "null" nie dowodzi, że pochodzenie jest wspólne.
Przypisanie do href może uruchomić nawigację, także do URL-a względnego; jeżeli adresu nie da się przetworzyć, zgłaszany jest DOMException o nazwie SyntaxError. Zapis do pathname lub search może rozpocząć nawigację ze zmienioną ścieżką lub zapytaniem. Próba zmiany ścieżki nieprzezroczystej nic nie robi. Początkowe ? i # są opcjonalne przy zapisie odpowiednio do search i hash. search = "" usuwa zapytanie, ale hash = "" może pozostawić końcowy #. Zmiana samego fragmentu zwykle nie wczytuje nowego dokumentu.
Próba odczytu tych pięciu właściwości w oknie o innym pochodzeniu może zgłosić DOMException o nazwie SecurityError. Zapis href jest wyjątkiem: można go użyć bez prawa odczytu, ale przeglądarka nadal może zablokować nawigację.
Przykłady
const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));Wynik
{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}Uruchom kod w Node.js. Odczytuje on te same składniki adresu z obiektu `URL`, a nie z przeglądarkowego obiektu `Location`, i nie uruchamia nawigacji. W wyniku `"null"` jest napisem, a `blank` nie zaczyna się od `/`.
Powiązane lekcje
- JavaScript · Lekcja 38 · Zaawansowany · Wersja: 4