Como funciona
Cada caractere fora do conjunto permitido é escrito como um sinal de porcentagem seguido por dois dígitos hexadecimais de seu byte UTF-8. encodeURIComponent escapa de tudo, exceto A-Z a-z 0-9 - _ . ! ~ * ( ) enquanto encodeURI mantém intacta a pontuação do URL reservado.
- Use o modo de componente para valores de consulta; o modo URL completo mantém: /? & = intacto.
Por que isso importa
As strings de consulta são quebradas de maneiras sutis: um termo de pesquisa contendo & cria silenciosamente um novo parâmetro, uma barra dentro de um nome de arquivo altera o caminho e um espaço termina em algum lugar inesperado. Codificar corretamente é a diferença entre um link funcional e um ticket de suporte.
Um exemplo trabalhado
encodeURIComponent("a b&c") retorna a%20b%26c, enquanto encodeURI mantém o & porque trata a string como um URL inteiro. Escolher o errado muda onde a consulta se divide.
Erros comuns
- Usando codificação de URL completa para um único valor de consulta.
- Esperando que decodeURIComponent transforme + em um espaço; isso é codificação de formulário.
- Codificando duas vezes e perguntando por que o servidor vê% 2520.
Dicas práticas
Codifique cada valor de consulta separadamente e, em seguida, crie o URL a partir das partes codificadas. Se um valor já parece codificado, decodifique-o uma vez e codifique-o novamente a partir da forma decodificada - a codificação repetida é a fonte mais comum de bugs do tipo %25.
Como usar
- Abra a ferramenta. Tudo roda na aba do seu navegador.
- Cole ou digite sua entrada e escolha a ação necessária.
- Verifique o resultado e copie-o com um clique.
Perguntas comuns
Quando devo usar componente versus URL completo?
Componente para um único valor de consulta, onde / ? & = deve ser escapado. O URL completo mantém esses separadores intactos.
Por que os espaços se tornam% 20?
A codificação percentual representa um espaço como% 20. O formulário + pertence à codificação do formulário HTML, não aos URLs.
Por que a decodificação deixa sinais +?
decodeURIComponent não trata + como um espaço. Substitua + por um espaço primeiro se o valor vier de um envio de formulário.
Esta ferramenta é realmente gratuita?
Sim. Não há conta, acesso pago e limite de uso. O Tools App é financiado pela aumenso, o estúdio por trás dele.
Alguma coisa que eu inseri foi carregada?
Não. A ferramenta é executada na aba do seu navegador; o que você insere nunca é enviado para nós e nunca é armazenado.