Encodage URL

Recommandations connexes

Qu'est-ce que l'encodage URL ?

Cas d'utilisation

• Débogage de paramètres API : compare les sorties d'encodeURIComponent et encodeURI pour résoudre les problèmes de non-correspondance de signature d'interface
• Décodage de journaux : décode par lots le contenu encodé URL dans les journaux pour restaurer un texte lisible
• Construction d'URL : le mode Query Only préserve les noms de clés et encode uniquement les valeurs, évitant les erreurs de format dues à la concaténation manuelle
• Développement frontend : le surlignage aide à comprendre quels caractères sont échappés, utile pour déboguer les redirections de page
• Migration de données : traite par lots les données encodées URL exportées de systèmes hérités pour les convertir au nouveau format

Comment utiliser

1. Saisissez ou collez l'URL ou le texte à encoder/décoder
2. Sélectionnez le sens d'encodage (Encoder/Décoder) et le mode (Component / URI / full / RFC 3986)
3. Activez le mode batch pour des données multilignes, ou Query Only pour encoder uniquement les valeurs des paramètres
4. Vérifiez le résultat surligné et copiez la chaîne encodée pour l'utiliser dans des requêtes API ou la construction d'URL

Fonctionnalités

• Quatre modes d'encodage : basculement en un clic entre encodeURIComponent / encodeURI / full / RFC 3986, comparaison en temps réel des différences de sortie
• Surlignage d'encodage : surligne en temps réel les caractères %XX échappés, marques de couleur ambre pour visualiser les résultats d'un coup d'œil
• Mode batch : support de l'encodage/décodage multiligne, chaque ligne est traitée indépendamment, idéal pour les journaux ou données par lots
• Mode Query Only : encode uniquement la partie valeur des paramètres URL (après le signe égal), en conservant intacts les noms de clés, symboles et structure de chemin
• Debounce en temps réel : encodage/décodage automatique en 300ms, pas besoin de cliquer sur un bouton, les résultats apparaissent pendant la saisie
• Compteur de caractères : affiche en temps réel le nombre de caractères saisis, pratique pour vérifier les limites de longueur des paramètres API

Exemples de code

// encodeURIComponent : encode les valeurs de paramètres individuelles (le plus courant)
const param = encodeURIComponent('张三&李四');
console.log(param); // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

// encodeURI : encode l'URL complète (conserve les caractères structurels :/?#&=)
const url = encodeURI('https://example.com/search?q=bonjour monde');
console.log(url);

// Décodage
const decoded = decodeURIComponent(param);
console.log(decoded); // 张三&李四

// Compatible RFC 3986 (~ n'est pas encodé)
function rfc3986Encode(str) {
  return encodeURIComponent(str).replace(/[!'()*]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase());
}

// API URLSearchParams (méthode moderne, encodage automatique)
const params = new URLSearchParams({ name: '张三', city: '北京' });
console.log(params.toString());
// name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

from urllib.parse import quote, unquote, urlencode, quote_plus

# quote : similaire à encodeURIComponent
encoded = quote('张三&李四')
print(encoded)  # %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

# Mode RFC 3986 (~ n'est pas encodé, c'est le défaut)
print(quote('hello~world'))  # hello~world

# quote_plus : les espaces sont encodés en + (format formulaire)
print(quote_plus('hello world'))  # hello+world

# Décodage
print(unquote(encoded))  # 张三&李四

# urlencode : construire une chaîne de requête
params = urlencode({'name': '张三', 'city': '北京'})
print(params)
# name=%E5%BC%A0%E4%B8%89&city=%E5%8C%97%E4%BA%AC

import java.net.URLEncoder;
import java.net.URLDecoder;
import java.net.URI;
import java.nio.charset.StandardCharsets;

public class URLEncodeExample {
    public static void main(String[] args) throws Exception {
        // Encodage URL (URLEncoder est format formulaire, espaces deviennent +)
        String encoded = URLEncoder.encode("张三&李四", "UTF-8");
        System.out.println(encoded);
        // %E5%BC%A0%E4%B8%89%26%E6%9D%8E%E5%9B%9B

        // Décodage
        String decoded = URLDecoder.decode(encoded, "UTF-8");
        System.out.println(decoded); // 张三&李四

        // Construire une URL complète (la classe URI gère automatiquement l'encodage)
        URI uri = new URI("https", "example.com", "/search", "q=bonjour", null);
        System.out.println(uri.toASCIIString());
    }
}

FAQ

Glossaire

Encodage pour cent (Percent-encoding)

Le nom officiel de l'encodage URL, une méthode d'encodage qui représente les caractères à l'aide de % suivi de deux chiffres hexadécimaux. Par exemple, l'espace est encodé en %20, le caractère chinois « 中 » en %E4%B8%AD.Wikipedia - Encodage pour cent

encodeURIComponent

Fonction intégrée de JavaScript qui encode tous les caractères à l'exception de A-Z a-z 0-9 - _ . ! ~ * ' ( ). Elle est le plus souvent utilisée pour encoder des valeurs individuelles de paramètres de requête URL.

encodeURI

Fonction intégrée de JavaScript qui préserve les caractères structurels de l'URL (: / ? # [ ] @ ! $ & ' ( ) * + , ; =) et n'encode que les caractères qui nécessitent réellement un encodage. Elle est utilisée pour encoder des URL complètes.

RFC 3986

La dernière norme IETF pour la syntaxe générique URI (2005), qui définit les règles d'encodage URL et classe le tilde ~ comme caractère non réservé (ne nécessitant pas d'encodage). Remplace les anciennes RFC 2396 et RFC 1738.RFC 3986

Caractères réservés (Reserved Characters)

Caractères ayant une signification spéciale dans les URL, tels que : / ? # [ ] @ ! $ & ' ( ) * + , ; =. Ces caractères doivent être encodés lorsqu'ils sont utilisés comme données, mais pas dans leurs positions structurelles.

Caractères non réservés (Unreserved Characters)

Caractères sécurisés pouvant être utilisés à n'importe quelle position dans une URL sans encodage, notamment A-Z, a-z, 0-9, -, _, ., ~ (selon RFC 3986).

Chaîne de requête (Query String)

La partie de l'URL après ?, composée de paires key=value séparées par &. Par exemple, dans ?name=张三&age=20, name=张三 et age=20 sont deux paramètres.

URLSearchParams

API fournie par les navigateurs modernes pour construire et analyser facilement des chaînes de requête URL, en gérant automatiquement l'encodage et le décodage. Plus sûre et fiable que la concaténation manuelle de chaînes.

application/x-www-form-urlencoded

Le format d'envoi par défaut des formulaires HTML, où les espaces sont encodés en + au lieu de %20, légèrement différent d'encodeURIComponent. Les frameworks côté serveur gèrent généralement les deux formats automatiquement.

Encodage UTF-8

L'encodage de caractères standard du Web. Dans l'encodage URL, les caractères non ASCII (tels que le chinois, les emoji) sont d'abord convertis en séquences d'octets UTF-8, puis chaque octet est encodé au format %XX.

Comparaison de l'échappement des caractères sur 4 modes d'encodage

Référence rapide des caractères réservés URL courants

Authoritative References

• ReferenceRFC 3986 - Identifiant uniforme de ressource (URI) : Syntaxe générique
• ReferenceRFC 1738 - Localisateurs uniformes de ressources (URL)
• ReferenceMDN Web Docs - encodeURIComponent()
• ReferenceMDN Web Docs - encodeURI()
• ReferenceWikipedia - Encodage pour cent