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

CKTIS / JavaScript

Location: fragment, izvor, pot, poizvedba in celoten URL

Preberi pet lastnosti URL-ja dokumenta in ugotovi, katere prireditve lahko sprožijo krmarjenje v brskalniku.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const loc = window.location;
loc.hash;      // string: fragment
loc.origin;    // string: URL origin (read-only)
loc.pathname;  // string: path
loc.search;    // string: query
loc.href;      // string: complete URL

// Assignments on a live Location can initiate navigation:
loc.hash = "intro";
loc.pathname = "/guide";
loc.search = "?mode=demo";
loc.href = "/guide?mode=demo#intro";

window.location vrne objekt Location, povezan z dokumentom. Gre za spletni API brskalnika, ne za del ECMAScripta 2024. Objekt odraža trenutni URL dokumenta, prej prebrani niz pa se ne posodablja. Z new URL(window.location.href) lahko pregledaš ali spremeniš ločen URL, ne da bi sprožil krmarjenje.

href je celoten serializirani URL. pathname vsebuje le pot, brez poizvedbe in fragmenta. Pri HTTP(S) se začne z /, tudi pri korenski poti. Neprosojna pot, na primer blank v about:blank, ne potrebuje začetne poševnice. search vrne neprazno poizvedbo z začetnim ?, hash pa neprazen fragment z začetnim #. Če ustreznega dela ni ali je prazen, lastnost vrne "", čeprav je ločilo lahko še vedno v href. Pri branju se odstotkovno kodiranje ne dekodira. Posamezne parametre poizvedbe preberi z new URLSearchParams(window.location.search).

origin je samo za branje in opisuje izvor URL-ja. Pri HTTP(S) vsebuje shemo, ime gostitelja in številko vrat, če vrata niso privzeta. Neprosojni izvor URL-ja se serializira kot niz "null", ne kot vrednost null. self.origin pa opisuje izvor izvajalnega okolja: dokument about:blank ga lahko podeduje. Enaka niza "null" ne dokazujeta, da sta izvora enaka.

Prireditev v href lahko sproži krmarjenje na drug URL, tudi relativen. Če razčlenjevanje ne uspe, se sproži DOMException z imenom SyntaxError. Prireditev v pathname ali search lahko sproži krmarjenje s spremenjeno potjo ali poizvedbo. Prireditev v pathname pri neprosojni poti nima učinka. Pri pisanju v search in hash začetna ? oziroma # nista obvezna. search = "" odstrani poizvedbo, hash = "" pa lahko pusti končni #. Sprememba samo fragmenta običajno ne naloži novega dokumenta.

Branje katere koli od teh petih lastnosti v oknu z drugim izvorom lahko sproži DOMException z imenom SecurityError. Pisanje v href je izjema: lahko je dovoljeno brez dostopa za branje, še vedno pa veljajo omejitve krmarjenja v brskalniku.

Primeri

const { hash, origin, pathname, search, href } = new URL("about:blank?mode=demo#intro");
console.log(JSON.stringify({ hash, origin, pathname, search, href }));

Rezultat

{"hash":"#intro","origin":"null","pathname":"blank","search":"?mode=demo","href":"about:blank?mode=demo#intro"}

Zaženi kodo v Node.js. Koda prebere iste dele URL-ja iz objekta `URL` namesto iz brskalnikovega objekta `Location` in ne sproži krmarjenja. V izpisu je `"null"` niz, `blank` pa se ne začne z `/`.

Povezane lekcije

  • JavaScript · Lekcija 38 · Napredna · Različica: 4

Viri