Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Sestavni deli URL-ja strani: origin, pathname, search, hash in href

Objekt window.location omogoča dostop do celotnega URL-ja trenutne strani in njegovih sestavnih delov. Spoznajte razlike med origin, pathname, search, hash in href ter zakaj lahko zapis v Location sproži navigacijo.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

window.location.origin
window.location.pathname
window.location.search
window.location.hash
window.location.href

window.location je objekt Location, povezan s trenutnim dokumentom; dostopen je tudi kot document.location. Njegove lastnosti opisujejo URL strani in vračajo nize. To je spletni API brskalnika, ne funkcija samega ECMAScripta. Prisotnost Node 24 v repozitoriju ne dokazuje podpore za brskalnikov Location.

Location.origin je samo za branje. Pri HTTP(S) vsebuje shemo, //, ime gostitelja in vrata, če niso privzeta; poti ne vsebuje. Pri file: je rezultat odvisen od brskalnika, zato pravil HTTP(S) ne posplošujte na vse sheme. Location.pathname vsebuje pot brez poizvedbe in fragmenta; pri HTTP(S) se začne z /.

Location.search vrne neprazno poizvedbo z začetnim znakom ?. Če poizvedbe ni ali je prazna, vrne "", tudi če se URL konča s samim znakom ?. Branje ne dekodira odstotkovnih zaporedij: %20 ostane %20. Za branje posameznih parametrov uporabite new URLSearchParams(window.location.search). Location.hash vrne neprazen fragment z začetnim znakom #. Če fragmenta ni ali je prazen, vrne "", tudi če se URL konča s samim znakom #. Location.href vrne celoten URL, vključno s poizvedbo in fragmentom.

Branje teh lastnosti strani ne spremeni, zapis v href pa sproži navigacijo. Sprememba pathname ali search lahko prav tako naloži dokument; sprememba samo hash običajno pomeni navigacijo znotraj istega dokumenta. Za varno pregledovanje poljubnega naslova uporabite URL namesto spreminjanja window.location. Primer uporablja ločen objekt URL z ustreznimi imeni lastnosti: rezultat je fiksen in stran se ne preusmeri. To ni preizkus navigacijskega vedenja Location.

Primeri

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]}`);
}

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri