WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = path

URL.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.

Quellen