CKTIS / JavaScript
decodeURI — descodificar um URI
decodeURI descodifica sequências percentuais no texto de um URI, preservando delimitadores codificados como %2F. Saiba em que difere de decodeURIComponent e como trata entradas malformadas.
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
decodeURI(encodedURI)decodeURI(encodedURI) é uma função global de ECMAScript destinada a descodificar URI completas. Primeiro converte o argumento numa cadeia de caracteres e, em seguida, devolve uma nova cadeia: as sequências %HH que representam bytes UTF-8 são convertidas nos caracteres Unicode correspondentes. Não altera a entrada nem requer APIs do navegador.
Preserva as sequências percentuais que representam ;/?:@&=+$,#, incluindo a utilização de maiúsculas e minúsculas nos dígitos hexadecimais. Assim, %20 transforma-se num espaço, mas %2F mantém-se como %2F. Um + literal também permanece inalterado: a função não descodifica a convenção dos formulários que representa os espaços com +.
decodeURIComponent destina-se a componentes individuais de URI e também descodifica delimitadores codificados, como %2F para /. Não a aplique indiscriminadamente a um URI completo, pois isso pode alterar os limites dos seus componentes. decodeURI não é um analisador nem um validador do endereço completo.
Uma sequência percentual malformada, como %ZZ, ou uma codificação UTF-8 incompleta ou inválida gera URIError, em vez de devolver um resultado parcial. Para dados externos, trate este caso com try...catch. Descodifique apenas a camada de codificação necessária: uma chamada adicional pode alterar novamente o resultado; por exemplo, %2520 transforma-se primeiro em %20 e depois num espaço.
Exemplos
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);
}Resultado
/café menu?q=a%2Fb+c /café menu?q=a/b+c 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.