Encodeur d'URL (encodage pourcent)

Comment encoder une chaîne pour une URL

1. Saisissez ou collez le texte dans Texte ou URL. La sortie se met à jour pendant la saisie.
2. Choisissez le mode sous Encoder :
   • Composant (encodeURIComponent) pour une valeur de requête, un champ de formulaire ou un segment de chemin.
   • URL complète (encodeURI) pour une URL entière qui contient des espaces ou des caractères non ASCII.
   • Données de formulaire (espace en +) pour les corps application/x-www-form-urlencoded et les query strings construites à la manière des formulaires HTML.
   • Tous les caractères pour encoder en pourcent tous les octets, lettres comprises, afin de tester des décodeurs.
3. Laissez Jeu de caractères sur UTF-8, sauf si le système destinataire attend un ancien encodage.
4. Cochez Chaque ligne séparément pour encoder une liste de valeurs d’un coup, puis Copier la sortie. Inverser envoie le résultat au décodeur pour vérifier l’aller-retour.

Une URL complète saisie est aussi découpée en schéma, hôte, chemin, chacun des paramètres de requête et fragment, dans un tableau sous les panneaux.

encodeURIComponent, encodeURI ou encodage de formulaire

La même entrée, a b&c=d/é?#+, dans les trois styles courants :

Composant ne laisse non échappés que A–Z a–z 0–9 - _ . ! ~ * ' ( ). URL complète garde en plus ; / ? : @ & = + $ , #, les caractères qui donnent sa structure à une URL : il ne peut donc pas protéger une valeur qui les contient. Données de formulaire ne garde que les lettres, les chiffres et - _ . *, et écrit les espaces sous forme de +.

Le bug classique consiste à construire une URL avec l’encodage URL complète : ?q=C++ & Go garde le + et le &, et le serveur reçoit q=C plus un paramètre parasite. Encodez plutôt la valeur avec Composant : ?q=C%2B%2B%20%26%20Go.

Espaces, signes plus et autres fauteurs de troubles

Le Base64 dans une URL est un cas typique du problème +, / et =. Encodez-le en pourcent comme un composant, ou passez au Base64URL, qui évite ces caractères.

Jeux de caractères autres que l’UTF-8

L’encodage pourcent travaille sur des octets : c’est donc le jeu de caractères qui détermine le résultat. é donne %C3%A9 en UTF-8 et %E9 en Windows-1252 ou ISO-8859-1. Les navigateurs et les API modernes utilisent l’UTF-8, mais d’anciennes applications PHP, certaines passerelles de paiement et des systèmes intranet hérités attendent encore du Latin-1 ou du Windows-1252, et les sites japonais parfois du Shift_JIS. Choisissez le jeu de caractères correspondant sous Jeu de caractères. Un caractère qui n’existe pas dans le jeu choisi ne peut pas être représenté : vérifiez la sortie pour ces cas-là.

L’encodage d’URL dans le code

encodeURIComponent("a b&c")              // "a%20b%26c"
new URLSearchParams({ q: "C++ & Go" }).toString()   // "q=C%2B%2B+%26+Go"

from urllib.parse import quote, quote_plus, urlencode
quote("/files/a b.txt")            # '/files/a%20b.txt'  (keeps / by default)
quote("/files/a b.txt", safe="")   # '%2Ffiles%2Fa%20b.txt'
quote_plus("a b&c")                # 'a+b%26c'
urlencode({"q": "C++ & Go"})       # 'q=C%2B%2B+%26+Go'

Le quote de Python garde / sauf si vous passez safe="", une surprise fréquente quand on encode une valeur. Ailleurs : en PHP, rawurlencode donne %20 et urlencode donne + ; en Java, URLEncoder.encode fait de l’encodage de formulaire avec + ; Go a url.PathEscape (%20) et url.QueryEscape (+). encodeURIComponent laisse ! ' ( ) * tels quels ; pour une sortie strictement RFC 3986, remplacez-les ensuite :

const strict = s => encodeURIComponent(s).replace(/[!'()*]/g,
  c => "%" + c.charCodeAt(0).toString(16).toUpperCase());

Le côté JavaScript est détaillé sur la page Base64 en JavaScript. Pour faire l’inverse, utilisez le décodeur d’URL.

FAQ