Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

decodeURIComponent — decodificare un componente URI

decodeURIComponent decodifica le sequenze percentuali in un singolo componente URI, interpretando i byte codificati come UTF-8. Restituisce testo, lascia + invariato e genera URIError in caso di codifica non valida.

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

decodeURIComponent(encodedURIComponent)

decodeURIComponent(encodedURIComponent) è una funzione globale di ECMAScript che decodifica un singolo componente URI. Per prima cosa converte l’argomento in una stringa, quindi sostituisce le sequenze %HH con i caratteri corrispondenti, interpretando i byte codificati come UTF-8. Restituisce una stringa senza modificare l’argomento.

A differenza di decodeURI, decodifica anche i caratteri riservati codificati, come %26, %2F e %3D. Dividi un indirizzo in componenti prima di decodificarne i valori: una decodifica anticipata può trasformare i dati in delimitatori. Un + letterale resta invariato; la funzione non lo considera uno spazio.

Le sequenze percentuali incomplete, le cifre esadecimali non valide o un UTF-8 non valido causano un URIError. Gestisci questa eccezione quando elabori input esterni. Decodifica in base al numero di livelli di codifica previsto: %252F diventa %2F dopo una chiamata e / dopo una seconda.

L’esempio mostra la decodifica di testo Unicode e caratteri riservati, il mantenimento di + e la gestione di un input non valido. Questa è una funzione del linguaggio ECMAScript, non un’API che richiede un ambiente browser.

Esempi

const encoded = "caf%C3%A9%20%26%20tea%2Bcake";
console.log(decodeURIComponent(encoded));
console.log(decodeURIComponent("a+b"));

try {
  decodeURIComponent("%E0%A4%A");
} catch (error) {
  console.log(error.name);
}

Risultato

café & tea+cake
a+b
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