CKTIS / JavaScript
URL — Adressen parsen und ändern
URL zerlegt eine Adresse in Bestandteile, löst relative Verweise auf und ermöglicht das Ändern von Abfrageparametern.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new URL(url, base?)URL ist eine WHATWG-API, kein Bestandteil von ECMAScript. new URL(url, base?) parst eine Adresse; für relative Verweise ist eine Basis erforderlich. Schlägt das Parsen fehl, wird ein TypeError ausgelöst.
href stellt die vollständig serialisierte Adresse bereit, pathname den Pfad. Bei HTTP(S) enthält origin das Schema, den Host und gegebenenfalls den Port, jedoch nicht den Pfad. Das Auflösen relativ zu einer Basis ist keine Verkettung: Ein abschließendes / ist relevant.
searchParams ist ein verknüpftes URLSearchParams-Objekt: Änderungen daran aktualisieren die Adresse. Werte sollten ohne vorherige Kodierung übergeben werden; Leerzeichen werden als + serialisiert. Erfolgreiches Parsen bedeutet nicht, dass eine Adresse sicher ist — prüfe, ob protocol und origin zulässig sind.
Beispiele
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Ergebnis
/app/items https://example.com/app/items?q=red+shoes
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.