CKTIS / JavaScript
`URL.origin`, `URL.pathname` e `URL.search`
Distingui l’origine, il percorso e la query di un URL già analizzato e leggi i singoli parametri senza suddividere l’indirizzo a mano.
Versione: Current web platform; runtime support varies
Sintassi
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 e search sono proprietà di un’istanza di URL, non metodi. URL è un’API della piattaforma web e non fa parte di ECMAScript 2024: verifica che il tuo ambiente di esecuzione la metta a disposizione. Usa new URL(input) per un URL assoluto e fornisci una base adatta con new URL(input, base) per un riferimento relativo. Se la base fornita non è valida o l’analisi fallisce, il costruttore genera un TypeError. Modificare l’oggetto URL non avvia la navigazione.
origin è di sola lettura. Per HTTP(S) contiene lo schema e il nome host, più la porta se non è quella predefinita. Non include credenziali, percorso, query o frammento. Un’origine opaca, come quella di un URL data:, viene serializzata come stringa "null", non come valore null. Due stringhe uguali di questo tipo non dimostrano che l’origine sia la stessa. Il risultato per file: dipende dall’implementazione.
pathname è il percorso serializzato, senza query o frammento. Per HTTP(S) inizia con / e il percorso radice è /. Le sequenze con codifica percentuale, come %20, non vengono decodificate automaticamente. Puoi assegnare un nuovo percorso HTTP(S). Altri schemi possono avere un percorso opaco senza / iniziale.
search restituisce la query con il ? iniziale, senza il frammento e senza decodificare le sequenze percentuali. Se la query è assente o vuota, anche nel caso di un semplice ?, restituisce "". Puoi assegnare una nuova query con o senza ? iniziale; assegnare "" la rimuove.
Usa url.searchParams.get("q") per leggere il valore decodificato di un parametro. Modificare searchParams aggiorna lo stesso oggetto URL e può cambiare la serializzazione dei valori esistenti: uno spazio scritto come %20 può diventare +. Usa href per leggere l’URL completo, frammento incluso.
Esempi
{
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);
}Risultato
https://shop.example /catalog/tea%20sets ?q=green%20tea green tea https://shop.example/catalog/tea%20sets?q=green+tea&page=2#reviews
La normalizzazione elimina la porta predefinita `443` e il segmento di percorso `.`. `search` conserva `%20`, `get("q")` restituisce un valore con uno spazio e, aggiungendo `page=2`, quello spazio viene rappresentato nella query come `+`.
Lezioni correlate
- JavaScript · Lezione 38 · Avanzato · Versione: 4