CKTIS / JavaScript
URL — parsování a úprava adres
URL rozkládá adresu na jednotlivé části, řeší relativní odkazy a umožňuje upravovat parametry dotazu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new URL(url, base?)URL je API standardu WHATWG, nikoli ECMAScriptu. new URL(url, base?) parsuje adresu; relativní odkazy vyžadují základní adresu. Pokud parsování selže, vyvolá se TypeError.
href zpřístupňuje úplnou serializovanou adresu, zatímco pathname zpřístupňuje její cestu. U HTTP(S) obsahuje origin schéma, hostitele a případný port, nikoli cestu. Řešení vůči základní adrese není konkatenace: koncové / je důležité.
searchParams je propojený objekt URLSearchParams: jeho úpravy aktualizují adresu. Předávej hodnoty bez předchozího kódování; mezery se serializují jako +. Úspěšné parsování neznamená, že je adresa bezpečná — ověř, zda jsou protocol a origin povolené.
Pří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ýsledek
/app/items https://example.com/app/items?q=red+shoes
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.