WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = url

Location.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.

Quellen