JavaScript href Eigenschaft

Das Location-Objekt besitzt, neben weiteren Eigenschaften, die Eigenschaft href. Sie dient der Speicherung der vollständigen URI des HTML-Dokuments, auf den sich das Location-Objekt bezieht. Dabei kann es sich ebenso um das Location-Objekt des aktuell angezeigten HTML-Dokuments (in der JavaScript Objekt-Hierarchie direkt unter Window) handeln, wie um das Location-Objekt eines eingebetteten Frames. Die href-Eigenschaft beinhaltet die jeweilige URI in Form einer Zeichenkette.

Neben dem lesenden Zugriff ist auch der schreibende Zugriff auf diese Eigenschaft möglich. Wird der gespeicherte Wert (die URI) in der href-Eigenschaft per Zuweisung eines neuen Wertes durch eine neue URI ersetzt, so wird der Browser umgehend zum Laden der entsprechenden URI veranlasst. (s. a. document.URL aus dem in JavaScript vordefinierten Objekt Document)

JavaScript location.href Beispiel

Das folgende Beispiel definiert zunächst einen Link, der – bei dessen Anklicken – schreibend auf die href-Eigenschaft zugreift. Der schreibende Zugriff erfolgt über den Zuweisungsoperator. Es wird eine neue URI angegeben (hier wird auf die HTML-Datei mit der Beschreibung des Location-Objekts verwiesen), die umgehend durch den Browser geladen wird.

Im darauf folgenden Scriptbereich wird die URI des derzeit durch den Browser angezeigten HTML-Dokuments unter Verwendung der JavaScript-Methode write() im HTML-Dokument ausgegeben. Dabei wird lesend auf die URI zugegriffen und das gelieferte String – nachdem es mit der davor angegebenen Zeichenkette zusammengefasst wurde – wird dann ausgegeben. Die Write-Methode ist Bestandteil des JavaScript Document-Objekts.

<a href="javascript:location.href = '/beispiele/javascript/location.html'" title="">gehe zu Location</a><br />
<script language="javascript" type="text/javascript">
<!-- // JavaScript-Bereich für ältere Browser auskommentieren
document.write ('URI des aktuell angezeigten HTML-Dokuments: ' + location.href);
// -->
</script>

gehe zu Location