Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

decodeURI — decodificare un URI

decodeURI decodifica le sequenze percentuali nel testo di un URI preservando i delimitatori codificati, come %2F. Scopri in cosa differisce da decodeURIComponent e come gestisce gli input non validi.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

decodeURI(encodedURI)

decodeURI(encodedURI) è una funzione globale ECMAScript pensata per decodificare URI complete. Per prima cosa converte il proprio argomento in una stringa, poi restituisce una nuova stringa: le sequenze %HH che rappresentano byte UTF-8 diventano i caratteri Unicode corrispondenti. Non modifica l’input e non richiede API del browser.

La funzione preserva le sequenze percentuali che rappresentano ;/?:@&=+$,#, inclusa la combinazione di maiuscole e minuscole delle cifre esadecimali. Di conseguenza, %20 diventa uno spazio, ma %2F resta %2F. Anche un + letterale rimane invariato: la funzione non decodifica la convenzione dei moduli che rappresenta gli spazi con +.

decodeURIComponent è pensata per i singoli componenti di un URI e decodifica anche i delimitatori codificati, per esempio %2F in /. Non applicarla indiscriminatamente a un URI completo, perché potrebbe modificare i confini dei suoi componenti. decodeURI non è un parser né un validatore dell’intero indirizzo.

Una sequenza percentuale non valida, come %ZZ, oppure una codifica UTF-8 incompleta o non valida genera URIError invece di restituire un risultato parziale. Per gli input esterni, gestisci questo caso con try...catch. Decodifica solo il livello di codifica necessario: un’altra chiamata può modificare di nuovo il risultato; per esempio, %2520 diventa prima %20 e poi uno spazio.

Esempi

const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));

try {
  decodeURI('%E0%A4');
} catch (error) {
  console.log(error.name);
}

Risultato

/café menu?q=a%2Fb+c
/café menu?q=a/b+c
URIError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti