WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

URL-Bestandteile der Seite: origin, pathname, search, hash und href

Das Objekt window.location stellt die vollständige URL der aktuellen Seite und ihre Bestandteile bereit. Erfahre, worin sich origin, pathname, search, hash und href unterscheiden und warum Schreibzugriffe auf Location eine Navigation auslösen können.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

window.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location ist ein mit dem aktuellen Dokument verknüpftes Location-Objekt; es ist auch als document.location verfügbar. Seine Eigenschaften beschreiben die Seiten-URL und liefern Zeichenfolgen. Dies ist eine Browser-Web-API und keine Funktion von ECMAScript selbst. Dass sich Node 24 in einem Repository befindet, belegt keine Unterstützung für das browserseitige Location.

Location.origin ist schreibgeschützt. Bei HTTP(S) enthält es das Schema, //, den Hostnamen und, falls nicht standardmäßig, den Port; der Pfad ist nicht enthalten. Bei file: hängt das Ergebnis vom Browser ab. Übertrage die Regeln für HTTP(S) daher nicht auf alle Schemas. Location.pathname enthält den Pfad ohne Abfrage und Fragment; bei HTTP(S) beginnt er mit /.

Location.search gibt eine nicht leere Abfrage mit vorangestelltem ? zurück. Fehlt die Abfrage oder ist sie leer, lautet der Rückgabewert "", auch wenn die URL mit einem einzelnen ? endet. Beim Lesen werden Prozentsequenzen nicht dekodiert: %20 bleibt %20. Verwende new URLSearchParams(window.location.search), um einzelne Parameter auszulesen. Location.hash gibt ein nicht leeres Fragment mit vorangestelltem # zurück. Fehlt das Fragment oder ist es leer, lautet der Rückgabewert "", auch wenn die URL mit einem einzelnen # endet. Location.href liefert die gesamte URL einschließlich Abfrage und Fragment.

Das Lesen dieser Eigenschaften ändert die Seite nicht, aber das Schreiben in href löst eine Navigation aus. Änderungen an pathname oder search können ebenfalls ein Dokument laden; eine Änderung nur von hash bedeutet üblicherweise eine Navigation innerhalb desselben Dokuments. Verwende zum sicheren Untersuchen einer beliebigen Adresse URL, statt window.location zu ändern. Das Beispiel verwendet ein separates URL-Objekt mit entsprechenden Eigenschaftsnamen: Die Ausgabe ist fest, und die Seite wird nicht weitergeleitet. Es ist kein Test des Navigationsverhaltens von Location.

Beispiele

const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
  console.log(`${key}: ${url[key]}`);
}

Ergebnis

origin: https://example.org:8443
pathname: /docs/start
search: ?q=web%20api
hash: #intro
href: https://example.org:8443/docs/start?q=web%20api#intro

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen