CKTIS / JavaScript
Location.href — Adresse lesen und navigieren
Location.href stellt die URL des Dokuments als Zeichenfolge bereit. Wird ein Wert zugewiesen, beginnt eine Navigation; es wird nicht einfach nur eine gewöhnliche Variable geändert.
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.href
window.location.href = urlLocation.href ist eine Eigenschaft der Browser-API und wird über window.location.href aufgerufen. Beim Lesen wird die serialisierte URL des Dokuments zurückgegeben, einschließlich Suchanfrage und Fragment, sofern vorhanden.
Die Zuweisung window.location.href = url beginnt eine Navigation. Der Setter löst eine relative Adresse anhand der API-Basis-URL des Einstiegseinstellungsobjekts (entry settings object) auf. Bei einem synchronen Aufruf zwischen Frames kann das die Basis-URL des Frames sein, der den Aufruf ausgelöst hat, statt der Basis-URL des Frames, dessen Code die Zuweisung ausführt. Eine ungültige Adresse kann eine SyntaxError-DOMException auslösen.
Das Lesen der Adresse eines anderen Fensters unterliegt Herkunftsbeschränkungen und kann einen SecurityError auslösen. Das Beispiel liest die Adresse nur aus; die Seite wird nicht verlassen.
Beispiele
const href = window.location.href;
console.log(typeof href);
console.log(href === window.location.toString());Ergebnis
string true
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.