CKTIS / JavaScript
`URL.origin`, `URL.pathname` a `URL.search`
Rozlišujte původ, cestu a dotaz zpracované adresy URL a čtěte jednotlivé parametry, aniž byste museli adresu ručně rozdělovat.
Verze: Current web platform; runtime support varies
Syntaxe
const url = new URL(input);
const resolved = new URL(input, base);
url.origin;
url.pathname;
url.search;
url.pathname = "/catalog";
url.search = "page=2";origin, pathname a search jsou vlastnosti instance URL, nikoli metody. URL je API webové platformy a není součástí ECMAScriptu 2024. Ověřte si proto, zda je ve vašem běhovém prostředí k dispozici. Pro absolutní adresu použijte new URL(input), pro relativní odkaz uveďte vhodnou základní adresu pomocí new URL(input, base). Pokud je zadaná základní adresa neplatná nebo zpracování selže, konstruktor vyvolá výjimku TypeError. Změna objektu URL nespouští navigaci.
origin je vlastnost jen pro čtení. U HTTP(S) obsahuje schéma, název hostitele a port, pokud se liší od výchozího. Neobsahuje přihlašovací údaje, cestu, dotaz ani fragment. Neprůhledný původ, například u adresy data:, se zapíše jako řetězec "null", nikoli jako hodnota null. Dva takové řetězce nedokazují shodný původ. Výsledek pro file: závisí na implementaci.
pathname je serializovaná cesta bez dotazu a fragmentu. U HTTP(S) začíná znakem / a kořenová cesta je /. Sekvence s procentovým kódováním, například %20, se automaticky nedekódují. U HTTP(S) lze přiřadit novou cestu. Jiná schémata mohou mít neprůhlednou cestu bez úvodního /.
search vrací dotaz s úvodním ?, bez fragmentu a bez dekódování procentových sekvencí. Pokud dotaz chybí nebo je prázdný, včetně případu se samotným ?, vrací "". Nový dotaz lze přiřadit s úvodním ? i bez něj; přiřazení "" dotaz odstraní.
Dekódovanou hodnotu parametru získáte pomocí url.searchParams.get("q"). Změna přes searchParams aktualizuje tentýž objekt URL a může změnit zápis stávajících hodnot: z mezery zapsané jako %20 se může stát +. Úplnou adresu včetně fragmentu získáte z href.
Příklady
{
const url = new URL("/catalog/./tea%20sets?q=green%20tea#reviews", "https://shop.example:443/");
console.log(url.origin);
console.log(url.pathname);
console.log(url.search);
console.log(url.searchParams.get("q"));
url.searchParams.set("page", "2");
console.log(url.href);
}Výsledek
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
Normalizace odstraní výchozí port `443` a segment cesty `.`. `search` zachová `%20`, `get("q")` vrátí hodnotu s mezerou a po přidání `page=2` se tato mezera v dotazu zapíše jako `+`.
Související lekce
- JavaScript · Lekce 38 · Pokročilá · Verze: 4