CKTIS / JavaScript
Компоненти на URL адреса на страницата: origin, pathname, search, hash и href
Обектът window.location предоставя пълния URL адрес на текущата страница и неговите компоненти. Научете как се различават origin, pathname, search, hash и href и защо записването в Location може да задейства навигация.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
window.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.hrefwindow.location е обект Location, свързан с текущия документ; достъпен е и като document.location. Свойствата му описват URL адреса на страницата и връщат низове. Това е уеб API на браузъра, а не функция на самия ECMAScript. Наличието на Node 24 в хранилище не доказва поддръжка на браузърния Location.
Location.origin е само за четене. При HTTP(S) съдържа схемата, //, името на хоста и порта, ако той не е по подразбиране; пътят не е включен. При file: резултатът зависи от браузъра, затова не обобщавайте правилата за HTTP(S) за всички схеми. Location.pathname съдържа пътя без заявката и фрагмента; при HTTP(S) започва с /.
Location.search връща непразната заявка с началния знак ?. Ако заявката липсва или е празна, връща "", включително когато URL адресът завършва със знак ?, след който няма нищо. При прочитане процентните последователности не се декодират: %20 остава %20. За прочитане на отделните параметри използвайте new URLSearchParams(window.location.search). Location.hash връща непразния фрагмент с началния знак #. Ако фрагментът липсва или е празен, връща "", включително когато URL адресът завършва със знак #, след който няма нищо. Location.href връща целия URL адрес, включително заявката и фрагмента.
Прочитането на тези свойства не променя страницата, но записването в href задейства навигация. Промяната на pathname или search също може да зареди документ; промяната само на hash обикновено означава навигация в рамките на същия документ. За безопасна проверка на произволен адрес използвайте URL, вместо да променяте window.location. Примерът използва отделен обект URL със съответстващи имена на свойства: резултатът е фиксиран и страницата не се пренасочва. Това не е тест на навигационното поведение на Location.
Примери
const url = new URL("https://example.org:8443/docs/start?q=web%20api#intro");
for (const key of ["origin", "pathname", "search", "hash", "href"]) {
console.log(`${key}: ${url[key]}`);
}Резултат
origin: https://example.org:8443 pathname: /docs/start search: ?q=web%20api hash: #intro href: https://example.org:8443/docs/start?q=web%20api#intro
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.