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.

Descrição

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

js
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® 2025 Language Specification
# sec-decodeuri-encodeduri

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
decodeURI

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Ver também