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.