CKTIS / JavaScript
URL — raščlanjivanje i izmjena adresa
URL rastavlja adresu na dijelove, razrješava relativne reference i omogućuje izmjenu parametara upita.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
new URL(url, base?)URL je API standarda WHATWG, a ne ECMAScripta. new URL(url, base?) raščlanjuje adresu; relativne reference zahtijevaju osnovnu adresu. Ako raščlanjivanje ne uspije, izbacuje se TypeError.
href daje potpuno serijaliziranu adresu, dok pathname daje njezinu putanju. Kod HTTP(S) protokola origin sadrži shemu, host i eventualni port, ali ne i putanju. Razrješavanje u odnosu na osnovnu adresu nije konkatenacija: završni / je važan.
searchParams je povezani objekt URLSearchParams: njegove izmjene ažuriraju adresu. Vrijednosti proslijedi bez prethodnog kodiranja; razmaci se serijaliziraju kao +. Uspješno raščlanjivanje ne znači da je adresa sigurna — provjeri jesu li protocol i origin dopušteni.
Primjeri
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Rezultat
/app/items https://example.com/app/items?q=red+shoes
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.