CKTIS / JavaScript
`URL.origin`, `URL.pathname` und `URL.search`
Unterscheide Ursprung, Pfad und Query einer geparsten URL und lies einzelne Query-Parameter aus, ohne die Adresse von Hand zu zerlegen.
Version: Current web platform; runtime support varies
Syntax
const url = new URL(input);
const resolved = new URL(input, base);
url.origin;
url.pathname;
url.search;
url.pathname = "/catalog";
url.search = "page=2";origin, pathname und search sind Eigenschaften einer URL-Instanz, keine Methoden. URL ist eine Web-API und nicht Teil von ECMAScript 2024. Prüfe daher, ob deine Laufzeitumgebung sie bereitstellt. Für eine absolute URL genügt new URL(input); für eine relative Referenz gib mit new URL(input, base) eine geeignete Basis an. Eine ungültige angegebene Basis oder ein Parsingfehler führt zu einem TypeError. Das Ändern des URL-Objekts löst keine Navigation aus.
origin ist schreibgeschützt. Bei HTTP(S) enthält es das Schema und den Hostnamen sowie den Port, falls dieser vom Standard abweicht. Zugangsdaten, Pfad, Query und Fragment gehören nicht dazu. Ein opaker Ursprung wie bei einer data:-URL wird als String "null" serialisiert, nicht als Wert null. Zwei solche Strings belegen keinen gemeinsamen Ursprung. Das Ergebnis für file: hängt von der Implementierung ab.
pathname ist der serialisierte Pfad ohne Query und Fragment. Bei HTTP(S) beginnt er mit /; der Wurzelpfad ist /. Prozentkodierte Sequenzen wie %20 werden nicht automatisch dekodiert. Einen neuen HTTP(S)-Pfad kannst du zuweisen. Bei anderen Schemata kann der Pfad opak sein und kein führendes / haben.
search liefert die Query mit führendem ?, ohne Fragment und ohne Dekodierung von Prozentsequenzen. Fehlt die Query oder ist sie leer, etwa bei einem alleinstehenden ?, ist das Ergebnis "". Eine neue Query kannst du mit oder ohne führendes ? zuweisen; "" entfernt sie.
Mit url.searchParams.get("q") liest du einen dekodierten Parameterwert. Änderungen an searchParams aktualisieren dasselbe URL-Objekt und können die Schreibweise vorhandener Werte ändern: Aus einem als %20 kodierten Leerzeichen kann + werden. href liefert die vollständige URL samt Fragment.
Beispiele
{
const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
console.log(url.origin);
console.log(url.pathname);
console.log(url.search);
console.log(url.searchParams.get("q"));
url.searchParams.set("page", "2");
console.log(url.href);
}Ergebnis
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
Bei der Normalisierung entfallen der Standardport `443` und das Pfadsegment `.`. `search` behält `%20` bei, `get("q")` liefert einen Wert mit Leerzeichen, und durch Hinzufügen von `page=2` wird dieses Leerzeichen in der Query als `+` dargestellt.
Zugehörige Lektionen
- JavaScript · Lektion 38 · Fortgeschritten · Version: 4