WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Location.hash und Location.href: Fragment oder vollständige URL

`Location.hash` liest oder ändert das URL-Fragment. `Location.href` liefert die vollständige URL oder stößt eine Navigation zum angegebenen Ziel an.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const fragment = window.location.hash;
const currentURL = window.location.href;
window.location.hash = fragmentString;
window.location.href = destinationURL;

window.location stellt das mit dem Dokument verknüpfte Location-Objekt bereit. Es handelt sich um eine Browser-API aus dem HTML Standard, nicht um einen Teil von ECMAScript 2024. Außerhalb eines Browserfensters ist sie nicht vorauszusetzen.

Beim Lesen liefert hash ein nicht leeres Fragment mit vorangestelltem #, ohne Prozentkodierungen zu dekodieren. Fehlt das Fragment oder ist es leer, lautet der Wert "". href liefert die vollständige URL als Zeichenfolge, einschließlich Query und Fragment, sofern vorhanden. Ein einzelnes # am Ende kann in href stehen, obwohl hash den Wert "" hat.

Eine Zuweisung an hash ändert nur das Fragment; ein führendes # ist optional. Bleibt das resultierende Fragment unverändert, findet keine Navigation statt. Die Zuweisung von "" setzt ein leeres Fragment, statt es zu entfernen. Eine Fragmentänderung durch Navigation im selben Dokument löst hashchange aus, ohne das Dokument neu zu laden.

Eine Zuweisung an href gibt ein Navigationsziel an. Relative URLs werden anhand der Basis-URL der aufrufenden Umgebung aufgelöst. Scheitert das Parsen, wirft der Browser eine DOMException namens SyntaxError. Origin-Regeln beschränken das Lesen beider Eigenschaften und das Schreiben von hash. Das Schreiben von href kann auch originübergreifend erlaubt sein, unterliegt aber weiterhin den Navigationsbeschränkungen.

Beispiele

(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();
  }
})();

Ergebnis

["","about:blank"]
["#details","about:blank#details"]
["#summary","about:blank#summary"]

Führe den Code in der Konsole einer normalen, vollständig geladenen HTTP(S)-Seite aus, die einen iframe ohne `sandbox`-Beschränkungen zulässt. Jede Zeile zeigt `[hash, href]`. Beide Zuweisungen ändern die URL des iframe, nicht die der übergeordneten Seite. In Node.js verwendet das Beispiel ein `URL`-Objekt statt `Location` und zeigt nur die URL-Serialisierung, ohne Navigation oder `hashchange`-Ereignisse.

Zugehörige Lektionen

  • JavaScript · Lektion 30 · Fortgeschritten · Version: 4

Quellen