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

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.

Sources