decodeURIComponent()

decodeURIComponent(text)

L’inverse d’encodeURIComponent() : remplace les séquences %XX par les caractères d’origine.

Paramètres

  • text – la chaîne encodée.

Valeur de retour

La chaîne décodée ; une séquence invalide déclenche URIError.

Exemples

console.log(decodeURIComponent('N%C3%AEmes%20%26%20th%C3%A9'));
console.log(decodeURIComponent('N%C3%AEmes+th%C3%A9'), new URLSearchParams('q=N%C3%AEmes+th%C3%A9').get('q'));
try {
  decodeURIComponent('100%');
} catch (e) {
  console.log(e.name);
}

Résultat :

Nîmes & thé
Nîmes+thé Nîmes thé
URIError

Points d’attention

  • Le signe + n’est pas transformé en espace (c’est ainsi que les formulaires envoient les espaces) – lisez les paramètres avec URLSearchParams, qui le gère.
  • Les données d’une adresse peuvent contenir des séquences invalides – entourez l’appel d’un bloc try...catch.

Prise en charge par les navigateurs

Baseline – largement disponible : fonctionne dans tous les navigateurs courants, et depuis longtemps (au plus tard depuis 2015). Depuis la version : Chrome 1, Firefox 1, Safari 1.1 ; Node.js 0.10.0. État : octobre 2026 (MDN browser-compat-data).

Voir aussi :
encodeURIComponent()
URLSearchParams