Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti