Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources