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

CKTIS / JavaScript

encodeURIComponent — codificação de um componente URI

encodeURIComponent codifica um único componente URI, como o valor de um parâmetro de consulta. Converte caracteres especiais e não ASCII em sequências percentuais que representam bytes UTF-8.

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

encodeURIComponent(uriComponent)

encodeURIComponent(uriComponent) é uma função global de ECMAScript, não uma API exclusiva dos navegadores. Converte o argumento numa cadeia de caracteres e devolve uma cadeia codificada. Utilize-a para um valor individual, não para um endereço completo.

Mantém inalteradas as letras A–Z, a–z, os algarismos 0–9 e - _ . ! ~ * ' ( ). Os outros caracteres tornam-se bytes UTF-8 escritos como %HH. Um espaço torna-se %20, não +; um + literal torna-se %2B.

Ao contrário de encodeURI, também codifica separadores como &, =, /, ? e #. Depois de codificados, esses caracteres não funcionam como delimitadores ao construir um URI. Os apóstrofos e os parênteses, por sua vez, mantêm-se inalterados e podem continuar a funcionar como delimitadores em certas sintaxes de URI, por exemplo, nos URL de OData. No entanto, não é um escape HTML nem uma validação de endereços. Se codificar o resultado novamente, % transforma-se em %25.

decodeURIComponent inverte a codificação de dados válidos. Um substituto UTF-16 sem par no argumento de encodeURIComponent provoca um URIError; a função não o substitui automaticamente. O exemplo mostra a codificação de um carácter Unicode, de um espaço e de separadores, e verifica depois se é possível reverter a codificação.

Exemplos

const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);

Resultado

%C5%BC%20%26%2B%2F
true

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