CKTIS / JavaScript
decodeURIComponent — descodificar um componente URI
decodeURIComponent descodifica sequências percentuais num componente URI individual, interpretando os bytes codificados como UTF-8. Devolve texto, mantém + inalterado e lança URIError se a codificação estiver malformada.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) é uma função global de ECMAScript para descodificar um componente URI individual. Primeiro converte o argumento numa cadeia de caracteres e, em seguida, substitui as sequências %HH pelos caracteres correspondentes, interpretando os bytes codificados como UTF-8. Devolve uma cadeia sem modificar o argumento.
Ao contrário de decodeURI, também descodifica caracteres reservados codificados, como %26, %2F e %3D. Separa um endereço em componentes antes de descodificar os respetivos valores: descodificar demasiado cedo pode transformar dados em delimitadores. Um + literal permanece inalterado; a função não o trata como um espaço.
Sequências percentuais incompletas, dígitos hexadecimais inválidos ou UTF-8 inválido causam um URIError. Trata esta exceção quando trabalhares com dados externos. Descodifica de acordo com o número de camadas de codificação esperado: %252F passa a %2F após uma chamada e a / após uma segunda.
O exemplo demonstra a descodificação de texto Unicode e caracteres reservados, a preservação de + e o tratamento de uma entrada malformada. Esta é uma função da linguagem ECMAScript, não uma API que exija um ambiente de navegador.
Exemplos
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);
}Resultado
café & tea+cake a+b URIError
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.