| Char | Decimal | Hex | URL Encoded | Name |
|---|---|---|---|---|
| 32 | 0x20 | %20 | Space | |
| ! | 33 | 0x21 | sem necessidade de codificação | Exclamation mark |
| " | 34 | 0x22 | %22 | Double quote |
| # | 35 | 0x23 | %23 | Hash / Number sign |
| $ | 36 | 0x24 | %24 | Dollar sign |
| % | 37 | 0x25 | %25 | Percent sign |
| & | 38 | 0x26 | %26 | Ampersand |
| ' | 39 | 0x27 | sem necessidade de codificação | Single quote / Apostrophe |
| ( | 40 | 0x28 | sem necessidade de codificação | Left parenthesis |
| ) | 41 | 0x29 | sem necessidade de codificação | Right parenthesis |
| * | 42 | 0x2A | sem necessidade de codificação | Asterisk |
| + | 43 | 0x2B | %2B | Plus sign |
| , | 44 | 0x2C | %2C | Comma |
| - | 45 | 0x2D | sem necessidade de codificação | Hyphen / Minus |
| . | 46 | 0x2E | sem necessidade de codificação | Period / Dot |
| / | 47 | 0x2F | %2F | Forward slash |
| 0 | 48 | 0x30 | sem necessidade de codificação | Zero |
| 1 | 49 | 0x31 | sem necessidade de codificação | |
| 2 | 50 | 0x32 | sem necessidade de codificação | |
| 3 | 51 | 0x33 | sem necessidade de codificação | |
| 4 | 52 | 0x34 | sem necessidade de codificação | |
| 5 | 53 | 0x35 | sem necessidade de codificação | |
| 6 | 54 | 0x36 | sem necessidade de codificação | |
| 7 | 55 | 0x37 | sem necessidade de codificação | |
| 8 | 56 | 0x38 | sem necessidade de codificação | |
| 9 | 57 | 0x39 | sem necessidade de codificação | Nine |
| : | 58 | 0x3A | %3A | Colon |
| ; | 59 | 0x3B | %3B | Semicolon |
| < | 60 | 0x3C | %3C | Less-than |
| = | 61 | 0x3D | %3D | Equals sign |
| > | 62 | 0x3E | %3E | Greater-than |
| ? | 63 | 0x3F | %3F | Question mark |
| @ | 64 | 0x40 | %40 | At sign |
| A | 65 | 0x41 | sem necessidade de codificação | Capital A |
| B | 66 | 0x42 | sem necessidade de codificação | |
| C | 67 | 0x43 | sem necessidade de codificação | |
| D | 68 | 0x44 | sem necessidade de codificação | |
| E | 69 | 0x45 | sem necessidade de codificação | |
| F | 70 | 0x46 | sem necessidade de codificação | |
| G | 71 | 0x47 | sem necessidade de codificação | |
| H | 72 | 0x48 | sem necessidade de codificação | |
| I | 73 | 0x49 | sem necessidade de codificação | |
| J | 74 | 0x4A | sem necessidade de codificação | |
| K | 75 | 0x4B | sem necessidade de codificação | |
| L | 76 | 0x4C | sem necessidade de codificação | |
| M | 77 | 0x4D | sem necessidade de codificação | |
| N | 78 | 0x4E | sem necessidade de codificação | |
| O | 79 | 0x4F | sem necessidade de codificação | |
| P | 80 | 0x50 | sem necessidade de codificação | |
| Q | 81 | 0x51 | sem necessidade de codificação | |
| R | 82 | 0x52 | sem necessidade de codificação | |
| S | 83 | 0x53 | sem necessidade de codificação | |
| T | 84 | 0x54 | sem necessidade de codificação | |
| U | 85 | 0x55 | sem necessidade de codificação | |
| V | 86 | 0x56 | sem necessidade de codificação | |
| W | 87 | 0x57 | sem necessidade de codificação | |
| X | 88 | 0x58 | sem necessidade de codificação | |
| Y | 89 | 0x59 | sem necessidade de codificação | |
| Z | 90 | 0x5A | sem necessidade de codificação | Capital Z |
| [ | 91 | 0x5B | %5B | Left square bracket |
| \ | 92 | 0x5C | %5C | Backslash |
| ] | 93 | 0x5D | %5D | Right square bracket |
| ^ | 94 | 0x5E | %5E | Caret |
| _ | 95 | 0x5F | sem necessidade de codificação | Underscore |
| ` | 96 | 0x60 | %60 | Backtick / Grave |
| a | 97 | 0x61 | sem necessidade de codificação | Lowercase a |
| b | 98 | 0x62 | sem necessidade de codificação | |
| c | 99 | 0x63 | sem necessidade de codificação | |
| d | 100 | 0x64 | sem necessidade de codificação | |
| e | 101 | 0x65 | sem necessidade de codificação | |
| f | 102 | 0x66 | sem necessidade de codificação | |
| g | 103 | 0x67 | sem necessidade de codificação | |
| h | 104 | 0x68 | sem necessidade de codificação | |
| i | 105 | 0x69 | sem necessidade de codificação | |
| j | 106 | 0x6A | sem necessidade de codificação | |
| k | 107 | 0x6B | sem necessidade de codificação | |
| l | 108 | 0x6C | sem necessidade de codificação | |
| m | 109 | 0x6D | sem necessidade de codificação | |
| n | 110 | 0x6E | sem necessidade de codificação | |
| o | 111 | 0x6F | sem necessidade de codificação | |
| p | 112 | 0x70 | sem necessidade de codificação | |
| q | 113 | 0x71 | sem necessidade de codificação | |
| r | 114 | 0x72 | sem necessidade de codificação | |
| s | 115 | 0x73 | sem necessidade de codificação | |
| t | 116 | 0x74 | sem necessidade de codificação | |
| u | 117 | 0x75 | sem necessidade de codificação | |
| v | 118 | 0x76 | sem necessidade de codificação | |
| w | 119 | 0x77 | sem necessidade de codificação | |
| x | 120 | 0x78 | sem necessidade de codificação | |
| y | 121 | 0x79 | sem necessidade de codificação | |
| z | 122 | 0x7A | sem necessidade de codificação | Lowercase z |
| { | 123 | 0x7B | %7B | Left curly brace |
| | | 124 | 0x7C | %7C | Pipe / Vertical bar |
| } | 125 | 0x7D | %7D | Right curly brace |
| ~ | 126 | 0x7E | sem necessidade de codificação | Tilde |
| Function | Encodes | Leaves alone | Use for |
|---|---|---|---|
| encodeURIComponent() | Everything except A-Z a-z 0-9 - _ . ! ~ * ' ( ) | Alphanumerics + - _ . ! ~ * ' ( ) | Query param values, path segments |
| encodeURI() | Unsafe chars, preserves : / ? # [ ] @ ! $ & ' ( ) * + , ; = | Most URI structural chars | Full URLs |
| escape() ✗ | Non-ASCII + some ASCII (deprecated) | @ * / + | Never — deprecated, use encodeURIComponent |
// Encode a single query param value (most common)
encodeURIComponent('hello world!') // → 'hello%20world!'
encodeURIComponent('price=100&qty=2') // → 'price%3D100%26qty%3D2'
// Build a URL with params safely
const params = new URLSearchParams({ q: 'hello world', page: '2' });
const url = 'https://example.com/search?' + params.toString();
// → https://example.com/search?q=hello+world&page=2
// Decode percent-encoded string
decodeURIComponent('hello%20world') // → 'hello world'
// Python
import urllib.parse
urllib.parse.quote('hello world') # → 'hello%20world'
urllib.parse.quote_plus('hello world') # → 'hello+world'
urllib.parse.urlencode({'q': 'hello world'}) # → 'q=hello+world'O caso de utilização mais comum. Ao construir URLs de pesquisa ou pedidos de API:
https://api.example.com/search?q=hello%20world&lang=en
Formulários HTML com method="GET" codificam os valores dos campos automaticamente. Os espaços tornam-se + na codificação de formulários (ligeiramente diferente do percent-encoding).
Nomes de ficheiros e identificadores de recursos nos caminhos de URLs também precisam de codificação. Um ficheiro chamado my report.pdf torna-se my%20report.pdf no URL.
JavaScript:
encodeURIComponent('hello world & more')
// "hello%20world%20%26%20more"
decodeURIComponent('hello%20world')
// "hello world"
Python:
from urllib.parse import quote, unquote
quote('hello world & more')
# 'hello%20world%20%26%20more'
%20 em %2520encodeURI em vez de encodeURIComponent — encodeURI ignora caracteres reservados que são importantes em valores de parâmetros+ — Nos URLs, + pode significar espaço. Codifique sinais de mais literais como %2BA codificação de formulários (application/x-www-form-urlencoded) utiliza + para espaços. O percent-encoding padrão utiliza %20. Ambos são válidos em contextos diferentes.
A codificação de URL substitui caracteres ASCII não seguros com um sinal de percentagem (%) seguido de dois dígitos hexadecimais representando o valor do byte. Por exemplo, um espaço torna-se %20 ou +. Isso garante que os URLs sejam válidos em todos os sistemas e protocolos.
RFC 3986 define quais caracteres são 'não reservados' (A-Z, a-z, 0-9, -, _, ., ~) e seguros para usar sem codificação. Todos os outros caracteres — incluindo espaços, <, >, #, %, {, }, |, \, ^, ` e caracteres não ASCII — devem ser codificados percentualmente.
%20 é a codificação percentual padrão RFC 3986 de um espaço e funciona em qualquer parte de um URL. O sinal + para espaços faz parte do formato application/x-www-form-urlencoded (formulários HTML) e é válido apenas em strings de consulta, não em caminhos.
Use encodeURIComponent() para codificar valores individuais de parâmetros de consulta: encodeURIComponent('hello world') → 'hello%20world'. Use encodeURI() para codificar um URL completo preservando a sua estrutura. Nunca use escape() — está obsoleto.