Spec-Zone.ru › Web APIs

Свойство URL: pathname

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Потоках веб-работы.

Свойство pathname интерфейса URL представляет собой местоположение в иерархической структуре. Это строка, составленная из списка сегментов пути, каждый из которых префиксен символом /.

HTTPS, HTTP или другие URL с иерархическими схемами (которые в стандарте URL называются "специальными схемами") всегда имеют по крайней мере один (невидимый) сегмент пути: пустую строку. Значение pathname для таких URL всегда будет содержать по крайней мере один символ /.

Для схем, не являющихся иерархическими, если URL не имеет сегментов пути, значение его свойства pathname будет пустой строкой.

Значение

Строка.

Примеры

Путь с невидимым сегментом

В приведенном ниже URL есть только один сегмент пути — пустая строка. Значение pathname строится путем добавления символа / к пустой строке.

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

Путь с параметрами запроса

В приведенном ниже примере показан путь для HTTPS-URL с параметрами запроса.

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"

Параметры запроса не являются частью пути. Обратите внимание, что некоторые системы используют символы ; и = для разграничения параметров и значений параметров, применимых к сегменту пути. Например, с URL https://example.org/users;id=42/tasks;state=open?sort=modified, система может извлечь и использовать параметры сегментов пути id=42 и state=open из сегментов пути users;id=42 и tasks;state=open.

Путь со слогом

В некоторых системах термин слог используется для обозначения конечного сегмента непустого пути, если он идентифицирует страницу с использованием понятных человеческим языком ключевых слов. Например, в URL ниже слогом является this-that-other-outre-collection.

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

Спецификации

Спецификация
URL
# dom-url-pathname

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
pathname 32 13
22До Firefox 53, pathname и search возвращали неправильные значения для пользовательских протоколов. При protocol:host/x?a=true&b=false, pathname возвращало "/x?a=true&b=false", а search возвращало "", вместо "/x" и "?a=true&b=false" соответственно. См. ошибку 1310483.
19 10 32
22До Firefox для Android 53, pathname и search возвращали неправильные значения для пользовательских протоколов. При protocol:host/x?a=true&b=false, pathname возвращало "/x?a=true&b=false", а search возвращало "", вместо "/x" и "?a=true&b=false" соответственно. См. ошибку 1310483.
19 10 2.0 4.4.3

См. также

  • Интерфейс URL, к которому он принадлежит.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/URL/pathname

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API