CKTIS / JavaScript
`URL.origin`, `URL.pathname` in `URL.search`
Razlikuj med izvorom, potjo in poizvedbo razčlenjenega URL-ja ter preberi posamezne parametre brez ročnega razdeljevanja naslova.
Različica: Current web platform; runtime support varies
Sintaksa
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 in search so lastnosti primerka URL, ne metode. URL je API spletne platforme in ni del ECMAScripta 2024, zato preveri, ali ga tvoje izvajalno okolje zagotavlja. Za absolutni URL uporabi new URL(input), pri relativnem sklicu pa podaj ustrezen osnovni URL z new URL(input, base). Če je podani osnovni URL neveljaven ali razčlenjevanje ne uspe, konstruktor sproži izjemo TypeError. Spreminjanje objekta URL ne sproži navigacije.
origin je samo za branje. Pri HTTP(S) vsebuje shemo in ime gostitelja ter vrata, če ta niso privzeta. Ne vključuje prijavnih podatkov, poti, poizvedbe ali fragmenta. Nepregleden izvor, kot je izvor URL-ja data:, se serializira v niz "null", ne v vrednost null. Dva taka niza ne dokazujeta istega izvora. Rezultat za file: je odvisen od implementacije.
pathname je serializirana pot brez poizvedbe in fragmenta. Pri HTTP(S) se začne z /, korenska pot pa je /. Odstotkovno kodirana zaporedja, kot je %20, se ne dekodirajo samodejno. Pri HTTP(S) lahko dodeliš novo pot. Druge sheme imajo lahko nepregledno pot brez začetnega /.
search vrne poizvedbo z začetnim ?, brez fragmenta in brez dekodiranja odstotkovno kodiranih zaporedij. Če poizvedbe ni ali je prazna, tudi pri samem ?, vrne "". Novo poizvedbo lahko dodeliš z začetnim ? ali brez njega; z dodelitvijo "" jo odstraniš.
Z url.searchParams.get("q") prebereš dekodirano vrednost parametra. Spreminjanje prek searchParams posodobi isti objekt URL in lahko spremeni zapis obstoječih vrednosti: presledek, zapisan kot %20, se lahko zapiše kot +. Celoten URL skupaj s fragmentom prebereš iz href.
Primeri
{
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);
}Rezultat
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
Normalizacija odstrani privzeta vrata `443` in odsek poti `.`. `search` obdrži `%20`, `get("q")` vrne vrednost s presledkom, po dodajanju `page=2` pa se ta presledek v poizvedbi zapiše kot `+`.
Povezane lekcije
- JavaScript · Lekcija 38 · Napredna · Različica: 4