CKTIS / JavaScript
URL — parsovanie a úprava adries
URL rozkladá adresu na jednotlivé časti, rieši relatívne odkazy a umožňuje upravovať parametre dopytu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new URL(url, base?)URL je API štandardu WHATWG, nie ECMAScriptu. new URL(url, base?) parsuje adresu; relatívne odkazy vyžadujú základnú adresu. Ak parsovanie zlyhá, vyvolá sa TypeError.
href sprístupňuje úplnú serializovanú adresu, zatiaľ čo pathname sprístupňuje jej cestu. Pri HTTP(S) obsahuje origin schému, hostiteľa a prípadný port, nie však cestu. Riešenie vzhľadom na základnú adresu nie je konkatenácia: koncové / je dôležité.
searchParams je prepojený objekt URLSearchParams: jeho úpravy aktualizujú adresu. Hodnoty odovzdávaj bez predchádzajúceho kódovania; medzery sa serializujú ako +. Úspešné parsovanie neznamená, že je adresa bezpečná — over, či sú protocol a origin povolené.
Príklady
const url = new URL("../items", "https://example.com/app/docs/");
url.searchParams.set("q", "red shoes");
console.log(url.pathname);
console.log(url.href);Výsledok
/app/items https://example.com/app/items?q=red+shoes
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.