CKTIS / JavaScript
decodeURIComponent — décoder un composant URI
decodeURIComponent décode les séquences en pourcentage d’un composant URI individuel, en interprétant les octets encodés comme de l’UTF-8. Elle renvoie du texte, laisse + inchangé et déclenche une URIError en cas d’encodage mal formé.
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
decodeURIComponent(encodedURIComponent)decodeURIComponent(encodedURIComponent) est une fonction globale d’ECMAScript qui décode un composant URI individuel. Elle convertit d’abord son argument en chaîne, puis remplace les séquences %HH par les caractères correspondants, en interprétant les octets encodés comme de l’UTF-8. Elle renvoie une chaîne sans modifier l’argument.
Contrairement à decodeURI, elle décode également les caractères réservés encodés, tels que %26, %2F et %3D. Séparez une adresse en composants avant d’en décoder les valeurs : un décodage prématuré peut transformer des données en délimiteurs. Un + littéral reste inchangé ; la fonction ne le traite pas comme une espace.
Les séquences en pourcentage incomplètes, les chiffres hexadécimaux invalides ou un UTF-8 invalide déclenchent une URIError. Gérez cette exception pour les données externes. Décodez selon le nombre de couches d’encodage attendu : %252F devient %2F après un appel, puis / après un deuxième.
L’exemple montre le décodage de texte Unicode et de caractères réservés, la conservation de + et la gestion d’une entrée mal formée. Il s’agit d’une fonction du langage ECMAScript, et non d’une API nécessitant un environnement de navigateur.
Exemples
const encoded = "caf%C3%A9%20%26%20tea%2Bcake";
console.log(decodeURIComponent(encoded));
console.log(decodeURIComponent("a+b"));
try {
decodeURIComponent("%E0%A4%A");
} catch (error) {
console.log(error.name);
}Résultat
café & tea+cake a+b URIError
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.