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

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.

Fontes