Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes