CKTIS / JavaScript
URL.pathname — den Pfad lesen und ändern
Mit URL.pathname kannst du den Pfad einer URL lesen oder ersetzen, ohne ihre Abfrage oder ihr Fragment zu ändern.
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
url.pathname
url.pathname = pathURL.pathname ist eine Instanzeigenschaft von URL und keine statische Eigenschaft des Konstruktors. Sie gibt den serialisierten Pfad ohne Abfrage oder Fragment zurück. Bei einer HTTPS-URL ohne Pfadsegmente gibt sie / zurück.
Durch Zuweisung wird der Pfad ersetzt; search und hash bleiben erhalten. Leerzeichen werden zu %20; beim Lesen werden prozentkodierte Sequenzen nicht automatisch dekodiert. Eine Änderung des Objekts löst keine Browsernavigation aus.
Undurchsichtige Pfade, etwa in mailto:person@example.org, können gelesen werden, eine Zuweisung an pathname wird jedoch ignoriert.
Beispiele
const url = new URL('https://example.org/docs/start?q=1#intro');
console.log(url.pathname);
url.pathname = '/learn JavaScript';
console.log(url.pathname);
console.log(url.href);Ergebnis
/docs/start /learn%20JavaScript https://example.org/learn%20JavaScript?q=1#intro
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.