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

CKTIS / JavaScript

decodeURI — décoder une URI

decodeURI décode les séquences en pourcentage dans le texte d’une URI tout en préservant les délimiteurs encodés tels que %2F. Découvrez en quoi elle diffère de decodeURIComponent et comment elle traite les données mal formées.

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

decodeURI(encodedURI)

decodeURI(encodedURI) est une fonction globale ECMAScript conçue pour décoder des URI complètes. Elle convertit d’abord son argument en chaîne, puis renvoie une nouvelle chaîne : les séquences %HH représentant des octets UTF-8 deviennent les caractères Unicode correspondants. Elle ne modifie pas l’entrée et ne nécessite aucune API de navigateur.

Elle préserve les séquences en pourcentage représentant ;/?:@&=+$,#, y compris la casse de leurs chiffres hexadécimaux. Ainsi, %20 devient une espace, mais %2F reste %2F. Un + littéral reste également inchangé : la fonction ne décode pas la convention des formulaires qui représente les espaces par +.

decodeURIComponent est destinée aux composants individuels d’une URI et décode aussi les délimiteurs encodés, par exemple %2F en /. Ne l’appliquez pas sans discernement à une URI complète, car cela peut modifier les limites de ses composants. decodeURI n’est ni un analyseur ni un validateur de l’adresse entière.

Une séquence en pourcentage mal formée, telle que %ZZ, ou un encodage UTF-8 incomplet ou invalide déclenche URIError au lieu de renvoyer un résultat partiel. Pour les données externes, gérez ce cas avec try...catch. Ne décodez que le niveau d’encodage nécessaire : un nouvel appel peut encore modifier le résultat ; par exemple, %2520 devient d’abord %20, puis une espace.

Exemples

const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));

try {
  decodeURI('%E0%A4');
} catch (error) {
  console.log(error.name);
}

Résultat

/café menu?q=a%2Fb+c
/café menu?q=a/b+c
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