Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła