Quand une URL doit être encodée
Un terme de recherche, une adresse e-mail ou une URL de redirection passée en paramètre doit être encodée, sinon ses &, = et ? cassent le lien. Le décodage fait l'inverse : lire un lien de suivi, une cible de redirection ou un journal d'erreurs plein de %2F et de %C3%A9, ou un lien copié depuis un e-mail dont les accents sont devenus illisibles.
Composant ou URL entière
Le mode composant encode tous les caractères réservés, & = / ? compris : à utiliser pour la valeur d'un paramètre. Le mode URL entière garde la structure (://, ?, #, &, =) et encode le reste : pour une adresse complète avec espaces ou accents. Les accents et autres caractères non ASCII sont encodés en octets UTF-8, ce qu'attendent navigateurs et serveurs.
Caractères réservés vs non réservés
Les caractères réservés (:, /, ?, #, [, ], @, !, $, &, ', (, ), *, +, ,, ;, =) ont une signification spéciale dans les URL. Ils ne doivent être encodés que lorsqu'ils sont utilisés en dehors de leur fonction réservée — par exemple, un / dans une valeur de paramètre doit être encodé en %2F.
Les caractères non réservés (lettres, chiffres, -, _, ., ~) n'ont jamais besoin d'être encodés. Les encoder est valide mais inutile et rend les URL plus longues.
Pièges courants
Le double encodage est l'erreur la plus courante : encoder une URL déjà encodée transforme %20 en %2520. Vérifiez toujours si votre entrée est déjà encodée avant de l'encoder à nouveau.
Le signe + est une autre source de confusion. Dans les chaînes de requête (application/x-www-form-urlencoded), + signifie espace. Mais dans le composant chemin d'une URL, + est littéral. Le decodeURIComponent de JavaScript ne décode PAS + en espace ; ici, l'interrupteur « + = espace » du mode Décoder s'en charge (activé par défaut) : désactivez-le quand le + fait partie d'un chemin.