Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Location: fragment, podrijetlo, putanja, upit i cijeli URL

Pročitaj pet svojstava URL-a dokumenta i razlikuj dodjele koje mogu pokrenuti navigaciju u pregledniku.

Verzija: 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 vraća objekt Location povezan s dokumentom. To je web API preglednika, a ne dio ECMAScripta 2024. Objekt odražava trenutačni URL dokumenta, ali prethodno pročitani znakovni niz ne ažurira se. Upotrijebi new URL(window.location.href) za pregled ili izmjenu zasebnog URL-a bez navigacije.

href je cijeli serijalizirani URL. pathname sadrži samo putanju, bez upita i fragmenta. Kod HTTP(S)-a počinje znakom /, čak i za korijensku putanju. Neprozirna putanja, poput blank u about:blank, ne mora počinjati kosom crtom. search vraća neprazan upit s početnim ?, a hash neprazan fragment s početnim #. Ako je odgovarajući dio odsutan ili prazan, rezultat je "", čak i ako je razdjelnik još vidljiv u href. Pri čitanju se ne dekodiraju postotno kodirane sekvence. Za čitanje pojedinačnih parametara upita upotrijebi new URLSearchParams(window.location.search).

origin je svojstvo samo za čitanje i opisuje podrijetlo URL-a. Kod HTTP(S)-a uključuje shemu, naziv glavnog računala i priključak ako nije zadani. Neprozirno podrijetlo URL-a serijalizira se kao znakovni niz "null", a ne kao vrijednost null. Nasuprot tome, self.origin opisuje podrijetlo okruženja izvršavanja: dokument about:blank može ga naslijediti. Dva jednaka niza "null" ne dokazuju da su podrijetla ista.

Dodjela vrijednosti u href može pokrenuti navigaciju na drugi URL, pa i relativan. Ako raščlamba ne uspije, baca se DOMException s nazivom SyntaxError. Dodjela u pathname ili search može pokrenuti navigaciju s promijenjenom putanjom ili upitom. Dodjela u pathname nema učinka ako je putanja neprozirna. Početni ? i # nisu obvezni pri pisanju u search odnosno hash. search = "" uklanja upit, ali hash = "" može ostaviti završni #. Promjena samo fragmenta obično ne učitava novi dokument.

Čitanje bilo kojeg od ovih pet svojstava u prozoru drugog podrijetla može baciti DOMException s nazivom SecurityError. Pisanje u href iznimka je: može biti dopušteno bez pristupa za čitanje, no ograničenja navigacije preglednika i dalje vrijede.

Primjeri

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"}

Pokreni kôd u Node.js-u. Kôd čita iste dijelove URL-a iz objekta `URL` umjesto iz objekta `Location` preglednika i ne pokreće navigaciju. U ispisu je `"null"` znakovni niz, a `blank` ne počinje znakom `/`.

Povezane lekcije

  • JavaScript · Lekcija 38 · Napredno · Verzija: 4

Izvori