CKTIS / JavaScript
URL.hash und URL.href: Fragment und vollständige URL
Mit `hash` liest oder änderst du das Fragment, mit `href` liest oder ersetzt du die gesamte URL. An `hash` allein erkennst du nicht, ob das Fragment leer ist oder fehlt.
Version: Current web platform; runtime support varies
Syntax
const url = new URL(input, base); // Omit base for an absolute input.
url.hash; // Fragment string
url.hash = fragment;
url.href; // Full serialized URL
url.href = absoluteUrl;hash und href sind Instanzeigenschaften von URL, keine Methoden oder statischen Eigenschaften. url.hash gibt ein nicht leeres Fragment mit vorangestelltem # zurück; ist das Fragment leer oder fehlt es, lautet der Rückgabewert "". url.href gibt die vollständig serialisierte URL einschließlich einer vorhandenen Query zurück. Ein abschließendes # in href unterscheidet ein leeres Fragment von einem fehlenden.
Weise url.hash den Fragmenttext mit oder ohne vorangestelltes # zu. Zeichen wie Leerzeichen werden bei Bedarf prozentkodiert, beim Lesen aber nicht automatisch dekodiert. url.hash = "" entfernt das Fragment; url.hash = "#" lässt ein leeres Fragment stehen. Das Fragment gehört nicht zur Query: url.searchParams dient zur Arbeit mit Query-Parametern, und das Fragment wird in einer HTTP-Anfrage nicht automatisch an den Server gesendet.
Eine Zuweisung an url.href parst den neuen Wert und ersetzt die gesamte URL im selben Objekt. Schlägt das Parsen fehl, wird ein TypeError ausgelöst. Der Setter löst relative Referenzen nicht gegen die aktuelle URL auf; verwende dafür new URL(relative, base).href mit einer gültigen Basis-URL.
Das Ändern eines URL-Objekts löst anders als eine Zuweisung an window.location.href keine Navigation aus. Prüfe vor der Navigation zu einer nicht vertrauenswürdigen URL, ob Schema und Origin erlaubt sind: Erfolgreiches Parsen macht die URL nicht sicher. URL ist eine Webplattform-API, kein Bestandteil von ECMAScript 2024; die Verfügbarkeit hängt von der Laufzeitumgebung ab.
Beispiele
{
const url = new URL("https://example.com/guide?lang=en");
const show = () => console.log(JSON.stringify([url.hash, url.href]));
url.hash = "quick start";
show();
url.hash = "#";
show();
url.hash = "";
show();
url.href = "https://example.org/start#intro";
show();
}Ergebnis
["#quick%20start","https://example.com/guide?lang=en#quick%20start"] ["","https://example.com/guide?lang=en#"] ["","https://example.com/guide?lang=en"] ["#intro","https://example.org/start#intro"]
Jede Zeile zeigt `[hash, href]`. Achte auf `%20`, das abschließende `#` nur in der zweiten Zeile und die vollständig ersetzte URL in der letzten Zeile.
Zugehörige Lektionen
- JavaScript · Lektion 30 · Fortgeschritten · Version: 4