decodeURI()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

A função decodeURI() decodifica um Uniform Resource Identifier (URI) criado anteriormente por encodeURI() ou por uma rotina semelhante.

Experimente

const uri = "https://mozilla.org/?x=шеллы";
const encoded = encodeURI(uri);
console.log(encoded);
// Expected output: "https://mozilla.org/?x=%D1%88%D0%B5%D0%BB%D0%BB%D1%8B"

try {
  console.log(decodeURI(encoded));
  // Expected output: "https://mozilla.org/?x=шеллы"
} catch (e) {
  // Catches a malformed URI
  console.error(e);
}

Sintaxe

decodeURI(encodedURI)

Parâmetros

encodedURI: Um identificador de recurso uniforme codificado completo.

Valor retornado

Uma nova string representando a versão não codificada do URI (Uniform Resource Identifier) codificado fornecido.

Exceções

Lança uma exceção URIError ("sequência de URI malformada") quando o encodedURI contém sequências de caracteres inválidos.

Substitui cada sequência de escape no URI codificado pelo caractere que ele representa, mas não decodifica sequências de escape que não poderiam ter sido introduzidas por encodeURI. O caractere "#" não é decodificado a partir de sequência de escape.

Exemplos

Decodificando uma URL Cyrillic

decodeURI(
  "https://developer.mozilla.org/ru/docs/JavaScript_%D1%88%D0%B5%D0%BB%D0%BB%D1%8B",
);
// "https://developer.mozilla.org/ru/docs/JavaScript_шеллы"

Captura de erros

try {
  var a = decodeURI('%E0%A4%A');
} catch(e) {
  console.error(e);
}

// URIError: sequência de URI malformada

Especificações

Specification
ECMAScript® 2026 Language Specification # sec-decodeuri-encodeduri