Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje