CKTIS / JavaScript
Location.hash i Location.href: fragment a pełny adres URL
`Location.hash` odczytuje lub zmienia fragment adresu, a `Location.href` zwraca pełny URL lub rozpoczyna nawigację pod wskazany adres.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;window.location udostępnia powiązany z dokumentem obiekt Location. To API przeglądarki z HTML Standard, a nie część ECMAScript 2024. Nie zakładaj, że jest dostępne poza kontekstem okna przeglądarki.
hash zwraca niepusty fragment z początkowym #, bez dekodowania sekwencji procentowych. Gdy fragmentu nie ma lub jest pusty, zwraca "". Z kolei href zwraca pełny URL jako ciąg znaków, wraz z parametrami zapytania i fragmentem, jeśli występują. Sam końcowy # może być widoczny w href, choć hash zwraca "".
Przypisanie do hash zmienia tylko fragment; początkowy # jest opcjonalny. Jeśli wynikowy fragment jest taki sam, przeglądarka nie nawiguje. Przypisanie "" ustawia pusty fragment, a nie usuwa go. Nawigacja zmieniająca fragment w tym samym dokumencie nie przeładowuje go i wywołuje zdarzenie hashchange.
Przypisanie do href wskazuje cel nawigacji. Względny URL jest rozwiązywany na podstawie bazowego URL środowiska wywołującego. Jeśli parsowanie się nie powiedzie, przeglądarka zgłasza DOMException o nazwie SyntaxError. Odczyt obu właściwości oraz zapis hash są chronione regułami pochodzenia. Zapis href może być dozwolony między różnymi originami, ale nadal podlega ograniczeniom nawigacji.
Przykłady
(async () => {
const show = address => console.log(JSON.stringify([address.hash, address.href]));
if (typeof document === 'undefined') {
// Node.js: URL serialization only, without navigation or hashchange.
const url = new URL('about:blank');
show(url);
url.hash = 'details';
show(url);
url.href = 'about:blank#summary';
show(url);
return;
}
const frame = document.createElement('iframe');
frame.hidden = true;
document.body.append(frame);
try {
const child = frame.contentWindow;
const location = child.location;
const nextHashChange = () => new Promise(resolve => {
child.addEventListener('hashchange', resolve, { once: true });
});
show(location);
const firstChange = nextHashChange();
location.hash = 'details';
await firstChange;
show(location);
const secondChange = nextHashChange();
location.href = 'about:blank#summary';
await secondChange;
show(location);
} finally {
frame.remove();
}
})();Wynik
["","about:blank"] ["#details","about:blank#details"] ["#summary","about:blank#summary"]
Uruchom kod w konsoli zwykłej strony HTTP(S) ze wczytanym dokumentem, która zezwala na ramkę bez ograniczeń `sandbox`. Każdy wiersz pokazuje parę `[hash, href]`. Oba przypisania zmieniają adres ramki, a nie adres strony nadrzędnej. W Node.js przykład używa obiektu `URL` zamiast `Location`, aby pokazać tylko serializację adresu, bez nawigacji i zdarzeń `hashchange`.
Powiązane lekcje
- JavaScript · Lekcja 30 · Zaawansowany · Wersja: 4