CKTIS / JavaScript
`URL.origin`, `URL.pathname` a `URL.search`
Rozlíšte pôvod, cestu a dopyt spracovanej adresy URL a čítajte jednotlivé parametre bez ručného rozdeľovania adresy.
Verzia: Current web platform; runtime support varies
Syntax
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 sú vlastnosti inštancie URL, nie metódy. URL je API webovej platformy, nie súčasť ECMAScriptu 2024. Overte si preto, či ho vaše vykonávacie prostredie poskytuje. Pre absolútnu adresu použite new URL(input), pre relatívny odkaz zadajte vhodnú základnú adresu pomocou new URL(input, base). Ak je zadaná základná adresa neplatná alebo spracovanie zlyhá, konštruktor vyvolá výnimku TypeError. Zmena objektu URL nespustí navigáciu.
origin je len na čítanie. Pri HTTP(S) obsahuje schému, názov hostiteľa a port, ak sa líši od predvoleného. Nezahŕňa prihlasovacie údaje, cestu, dopyt ani fragment. Nepriehľadný pôvod, napríklad pri adrese data:, sa serializuje ako reťazec "null", nie ako hodnota null. Dva takéto reťazce nedokazujú rovnaký pôvod. Výsledok pre file: závisí od implementácie.
pathname je serializovaná cesta bez dopytu a fragmentu. Pri HTTP(S) sa začína znakom / a koreňová cesta je /. Sekvencie s percentovým kódovaním, napríklad %20, sa automaticky nedekódujú. Pri HTTP(S) môžete priradiť novú cestu. Iné schémy môžu mať nepriehľadnú cestu bez úvodného /.
search vracia dopyt s úvodným ?, bez fragmentu a bez dekódovania percentových sekvencií. Ak dopyt chýba alebo je prázdny, a to aj pri samotnom ?, vráti "". Nový dopyt môžete priradiť s úvodným ? alebo bez neho; priradením "" ho odstránite.
Dekódovanú hodnotu parametra získate pomocou url.searchParams.get("q"). Zmena cez searchParams aktualizuje ten istý objekt URL a môže zmeniť zápis existujúcich hodnôt: medzera zapísaná ako %20 sa môže zmeniť na +. Úplnú adresu vrátane fragmentu získate z href.
Prí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ýsledok
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
Normalizácia odstráni predvolený port `443` a segment cesty `.`. `search` zachová `%20`, `get("q")` vráti hodnotu s medzerou a po pridaní `page=2` sa táto medzera v dopyte zapíše ako `+`.
Súvisiace lekcie
- JavaScript · Lekcia 38 · Pokročilá · Verzia: 4