CKTIS / JavaScript
encodeURIComponent — encodage d’un composant d’URI
encodeURIComponent encode un composant d’URI unique, par exemple la valeur d’un paramètre de requête. Il convertit les caractères spéciaux et non ASCII en séquences de pourcentage représentant des octets UTF-8.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) est une fonction globale d’ECMAScript, et non une API réservée aux navigateurs. Elle convertit son argument en chaîne et renvoie une chaîne encodée. Utilisez-la pour une valeur individuelle, pas pour une adresse entière.
Elle laisse inchangés les lettres A–Z, a–z, les chiffres 0–9 et - _ . ! ~ * ' ( ). Les autres caractères deviennent des octets UTF-8 écrits sous la forme %HH. Une espace devient %20, et non + ; un caractère + littéral devient %2B.
Contrairement à encodeURI, elle encode également les séparateurs tels que &, =, /, ? et #. Une fois encodés, ces caractères ne jouent plus le rôle de délimiteurs lors de la construction d’une URI. Les apostrophes et les parenthèses restent en revanche inchangées et peuvent encore servir de délimiteurs dans certaines syntaxes d’URI, par exemple dans les URL OData. Ce n’est toutefois ni un échappement HTML ni une validation d’adresse. Encoder le résultat une deuxième fois transforme % en %25.
decodeURIComponent inverse l’encodage de données valides. Un substitut UTF-16 isolé dans l’argument de encodeURIComponent provoque une URIError ; la fonction ne le remplace pas automatiquement. L’exemple montre l’encodage d’un caractère Unicode, d’une espace et de séparateurs, puis vérifie la réversibilité.
Exemples
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Résultat
%C5%BC%20%26%2B%2F true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.