URL: pathname-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die pathname-Eigenschaft des URL-Interfaces repräsentiert einen Ort in einer hierarchischen Struktur. Sie ist ein String, der aus einer Liste von Pfadsegmenten konstruiert wird, von denen jedes mit einem /-Zeichen vorangestellt wird.

HTTPS-, HTTP- oder andere URLs mit hierarchischen Schemata (die der URL-Standard als "besondere Schemata" bezeichnet) haben immer mindestens ein (unsichtbares) Pfadsegment: den leeren String. Der pathname-Wert für solche URLs hat daher immer mindestens ein /-Zeichen.

Für nicht-hierarchische Schemata, wenn die URL keine Pfadsegmente hat, ist der Wert ihrer pathname-Eigenschaft der leere String.

Wert

Ein String.

Beispiele

Pfadname mit unsichtbarem Segment

Die untenstehende URL hat nur ein Pfadsegment, den leeren String. Der pathname-Wert wird durch ein vorangestelltes /-Zeichen zum leeren String konstruiert.

js
const url = new URL("https://developer.mozilla.org");
console.log(url.pathname); // Logs "/"

Pfadname mit Abfrageparametern

Das folgende Beispiel zeigt den Pfadnamen für eine HTTPS-URL mit Abfrageparametern.

js
const url = new URL(
  "https://developer.mozilla.org/en-US/docs/Web/API/URL/pathname?q=value",
);
console.log(url.pathname); // Logs "/en-US/docs/Web/API/URL/pathname"

Die Abfrageparameter sind nicht Bestandteil des Pfades. Beachten Sie, dass einige Systeme die Zeichen ; und = verwenden, um Parameter und Parameterwerte für ein Pfadsegment zu trennen. Zum Beispiel könnte ein System bei der URL https://example.org/users;id=42/tasks;state=open?sort=modified die Pfadsegmentparameter id=42 und state=open aus den Pfadsegmenten users;id=42 und tasks;state=open extrahieren und verwenden.

Pfadname mit einem Slug

Einige Systeme definieren den Begriff Slug als das letzte Segment eines nicht-leeren Pfades, wenn es eine Seite in menschenlesbaren Schlüsselwörtern identifiziert. Beispielsweise hat die untenstehende URL den Slug this-that-other-outre-collection.

js
const url = new URL(
  "https://example.org/articles/this-that-other-outre-collection",
);
console.log(url.pathname); // Logs "/articles/this-that-other-outre-collection"

Spezifikationen

Specification
URL
# dom-url-pathname

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
pathname

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

Siehe auch

  • Das URL-Interface, zu dem es gehört.