WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Location: Fragment, Ursprung, Pfad, Abfrage und vollständige URL

Lies die fünf URL-Eigenschaften eines Browserdokuments und erkenne, welche Zuweisungen eine Navigation auslösen können.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location liefert das zum Dokument gehörende Location-Objekt. Es ist Teil einer Browser-API, nicht von ECMAScript 2024. Das Objekt spiegelt die aktuelle URL wider; eine zuvor gelesene Zeichenfolge ändert sich nicht mit. Mit new URL(window.location.href) kannst du eine separate URL ohne Navigation untersuchen und bearbeiten.

href ist die vollständige serialisierte URL. pathname enthält nur den Pfad, ohne Abfrage und Fragment. Bei HTTP(S) beginnt er auch für den Wurzelpfad mit /. Ein opaker Pfad wie blank in about:blank braucht keinen führenden Schrägstrich. search liefert eine nicht leere Abfrage mit ?, hash ein nicht leeres Fragment mit #. Fehlt der jeweilige Teil oder ist er leer, lautet das Ergebnis "", auch wenn das Trennzeichen noch in href steht. Beim Lesen wird die Prozentkodierung nicht dekodiert. Einzelne Abfrageparameter liest du mit new URLSearchParams(window.location.search).

origin ist schreibgeschützt und beschreibt den Ursprung der URL. Bei HTTP(S) enthält er das Schema und den Hostnamen sowie einen vom Standard abweichenden Port. Ein opaker URL-Ursprung ergibt die Zeichenfolge "null", nicht den Wert null. self.origin bezeichnet dagegen den Ursprung der Ausführungsumgebung: Ein about:blank-Dokument kann diesen erben. Zwei Zeichenfolgen mit dem Wert "null" belegen keinen gemeinsamen Ursprung.

Eine Zuweisung an href kann zu einer neuen, auch relativen URL navigieren. Schlägt das Parsen fehl, wird eine DOMException namens SyntaxError ausgelöst. Zuweisungen an pathname oder search können mit geändertem Pfad oder geänderter Abfrage navigieren. Bei einem opaken Pfad bleibt eine Zuweisung an pathname wirkungslos. Beim Setzen von search und hash sind das führende ? beziehungsweise # optional. search = "" entfernt die Abfrage, aber hash = "" kann ein abschließendes # stehen lassen. Eine reine Fragmentänderung lädt normalerweise kein neues Dokument.

Beim Lesen einer dieser fünf Eigenschaften in einem Fenster mit anderem Ursprung kann eine DOMException namens SecurityError auftreten. href zu schreiben ist eine Ausnahme: Das geht unter Umständen auch ohne Leserecht, doch die Navigationsbeschränkungen des Browsers gelten weiterhin.

Beispiele

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Ergebnis

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Führe den Code in Node.js aus. Er liest dieselben URL-Bestandteile aus einem `URL`-Objekt statt aus einem `Location`-Objekt des Browsers und löst keine Navigation aus. In der Ausgabe ist `"null"` eine Zeichenfolge, und `blank` beginnt nicht mit `/`.

Zugehörige Lektionen

  • JavaScript · Lektion 38 · Fortgeschritten · Version: 4

Quellen