info@a-coding-project.de

JavaScript: location

Das clientseitige location-Objekt besitzt Eigenschaften und Methoden, die die aktuelle Adresse der Seite wiedergeben bzw. diese bearbeiten lassen.
Das location-Objekt ist Unterobjekt des window-Objekts, kann aber zur Verkürzung der Schreibweise auch ohne window angesprochen werden (also nur location...).
Bitte beachten Sie, dass das Objekt selbst auch gleichzeitig zum Setzen der Adresse dienen kann. location kann zur Verkürzung der Schreibung als Synonym für die location.href-Eigenschaft eingesetzt werden. Beispiel:

location.href = 'https://www.a-coding-project.de';
// ... ist equvalent zu:
location = 'https://www.a-coding-project.de';

Eigenschaften  nach oben

hash

Die hash-Eigenschaft gibt den verwendeten Anker aus (alles nach und inklusive einem # innerhalb der URL). Von https://www.example.com:80/program/js_1.htm#entstehung wird #entstehung zurückgegeben.
Notation: Objekt.hash

a = location.hash;

host

Die host-Eigenschaft gibt einen String aus, der den Host-Namen, eventuelle Subdomains sowie die Domain enthält. Leider unterscheiden sich hier JavaScript und JScript: JScript gibt den außerdem den Port mit aus. Von https://www.example.com:80/program/js_1.htm#entstehung wird unter JavaScript www.html-world.de zurückgegeben - unter JScript www.html-world.de:80.
Notation: Objekt.host

if(location.host.search('html-world.de') == -1)
{alert('Sie haben diese Seite vom falschen Server abgerufen!');}

hostname

Die hostname-Eigenschaft gibt den Host-Namen, eventuelle Subdomains sowie die Domain aus. Unter JavaScript wird - im Gegensatz zu JScript - zusätzlich noch der Port mit angegeben. Von https://www.example.com:80/program/js_1.htm#entstehung wird unter JavaScript www.html-world.de:80 zurückgegeben - unter JScript www.html-world.de.
Notation: Objekt.hostname

if(location.hostname.search('html-world.de') == -1)
{alert('Sie haben diese Seite vom falschen Server abgerufen!');}

href

Die href-Eigenschaft gibt die gesamte Adresse der Seite wieder. (Bitte beachten Sie den Zusammenhang zwischen location und loaction.href.)
Notation: Objekt.href

location.href = 'https://www.a-coding-project.de';

pathname

Die pathname-Eigenschaft gibt den Pfad der Datei aus. Von https://www.example.com:80/program/js_1.htm#entstehung wird /program/js_1.htm zurückgegeben.
Notation: Objekt.pathname
Kein Beispiel.

port

Die port-Eigenschaft gibt den Verwendeten Port aus. Wird ein leerer String zurückgegeben bzw. angegeben, so wurde bzw. wird der für das entsprechende Protokoll vorgesehene Port verwendet ( HTTP = 80,FTP= 21, ...). Von https://www.example.com:80/program/js_1.htm#entstehung wird 80 zurückgegeben.
Notation: Objekt.port

if(location.port != '')
{
 if(location.port != '80')
 {alert('Sie verwenden den falschen Port. Bitte benutzen Sie Port 80!');}
}

protocol

Die protocol-Eigenschaft gibt das verwendete Protokoll aus. Von https://www.example.com:80/program/js_1.htm#entstehung wird http: zurückgegeben.
Notation: Objekt.protocol

a = location.protocol;

search

Die search-Eigenschaft gibt den Suchstring der Seite aus. Von https://www.example.com:80/program/js_1.htm?abc=def wird ?abc=def zurückgegeben.
Notation: Objekt.search

if(location.search.search('gehezu=html') != -1)
{location.href = 'https://www.example.com/program/html_1.htm';}

Methoden  nach oben

assign

Die assign-Methode läd eine neue Adresse. Als Parameter muss die zu ladende Adresse angegeben werden.
Notation: Objekt.assign(URL)

location.assign('https://www.a-coding-project.de');

reload

Die reload-Methode läd die aktuelle Seite erneut. Dazu kann optional ein boolescher Parameter übergeben werden. Dieser besagt, ob die Seite erneut vom Server abgerufen werden soll (true), oder ob sie eventuell aus dem Cache geladen werden soll (false).
Notation: Objekt.reload([vomServer])

location.reload(true);

replace

Die replace-Methode lädt eine Adresse und ersetzt diese durch die letzte in der History (Verlauf). Somit ist es dem Benutzer nicht möglich mit Hilfe des Zurück-Buttons am Browser die letztbesuchte Seite aufzurufen. Als Parameter wird die entsprechende Adresse erwartet.
Notation: Objekt.replace(URL)

location.replace('https://www.a-coding-project.de');

Über uns

Stefan Wienströer

Wir entwickeln Webanwendungen mit viel Leidenschaft. Unser Wissen geben wir dabei gerne weiter. Mehr über a coding project

Auch interessant