Outil encodeURIComponent

Lorsque vous construisez une chaîne de requête, une simple esperluette ou une espace non échappée suffit à scinder un paramètre et à casser une intégration. Cet outil encodeURIComponent applique exactement les mêmes règles que les fonctions JavaScript encodeURIComponent et decodeURIComponent : à l'aller, les caractères réservés deviennent des séquences percent-encoded, et au retour, les séquences %XX valides redeviennent un texte lisible.

Ce que protège réellement encodeURIComponent

Une URL complète n'est pas un bloc opaque unique. Les schémas, les séparateurs de chemin, les délimiteurs de requête et les marqueurs de fragment ont une signification structurelle. encodeURIComponent est la fonction à employer lorsque la valeur doit voyager comme donnée à l'intérieur de cette structure sans réécrire la structure elle-même.

Les espaces deviennent %20, les esperluettes %26, les signes égal %3D, et le texte non-ASCII, comme les lettres accentuées ou les emoji, est développé en séquences percent UTF-8 afin que les proxys et les serveurs ne se trompent pas sur les frontières d'octets. C'est là toute la différence avec encodeURI, qui laisse de nombreux caractères réservés intacts parce qu'il suppose que vous encodez une adresse entière.

Si vous encodez un lien https:// complet avec les règles de composant, les deux-points et les barres obliques se transforment en séquences % et le lien cesse de fonctionner. Si vous laissez un terme de recherche en texte libre non encodé et que vous le collez après ?, une esperluette insérée ressemble à un nouveau paramètre.

Cet outil utilise toujours la sémantique de composant, de sorte que chaque valeur peut être placée sans risque après une clé, entre des segments de chemin lorsque le segment est une donnée, ou à l'intérieur d'un corps de formulaire qui deviendra plus tard une requête.

Comment l'utiliser et lire le résultat

Envoyez un champ text contenant la chaîne qui vous intéresse et, en option, un champ mode réglé sur encode ou decode. encode est la valeur par défaut : le moteur exécute encodeURIComponent sur l'entrée et renvoie mode, l'entrée d'origine, la sortie transformée et la longueur de la sortie, afin que les pipelines puissent vérifier des budgets de taille sans seconde passe. decode exécute decodeURIComponent et renvoie la même structure avec la chaîne restaurée dans output. Les chaînes vides sont valides et font l'aller-retour vers des chaînes vides.

Un champ text manquant échoue également à la validation avant toute transformation. Préférez encoder chaque valeur, puis les assembler avec des caractères & et = littéraux, plutôt que d'encoder une chaîne de requête déjà construite, afin que les délimiteurs restent structurels et que seuls les caractères de charge utile soient échappés.

Où l'encodage de composant s'intègre aux flux réels

Les interfaces de recherche et de filtrage construisent des liens partageables à partir de phrases saisies par l'utilisateur qui contiennent des espaces, des guillemets et des écritures non latines ; encoder chaque champ avant l'assemblage garde le lien partagé stable d'un client de messagerie à l'autre et dans les applications de chat qui réécrivent les URL brutes.

Les outils de journalisation et de support affichent souvent des lignes de requête brutes avec des séquences percent ; décoder ces valeurs restitue les termes de recherche ou les noms de fichiers d'origine pour l'analyse, sans passer par une console jetable. Les migrations de données inversent des colonnes doublement encodées lorsque d'anciens exporteurs encodaient deux fois, ou appliquent un unique encodage de composant cohérent au stockage de valeurs qui seront ensuite insérées dans des redirections.

Les listes de contrôle pour l'enseignement et la revue de code s'appuient sur une référence encodeURIComponent réputée correcte, afin que les développeurs juniors puissent comparer les helpers propres à chaque langage au comportement de référence de JavaScript et repérer les bibliothèques qui traitent différemment les signes plus ou les tildes.