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

CKTIS / JavaScript

URIError — échec de l’encodage ou du décodage d’une URI

URIError est un type d’erreur intégré à JavaScript qui signale des données mal formées lors de l’encodage ou du décodage d’une URI. Découvrez ses causes courantes, comment le créer et comment traiter certaines exceptions de façon ciblée.

Version : Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.

Syntaxe

new URIError(message)
URIError(message)

URIError est un type d’erreur standard d’ECMAScript qui hérite de Error ; ce n’est pas une interface d’API Web. Il ne désigne pas n’importe quelle adresse invalide, mais les échecs des opérations d’encodage et de décodage d’URI.

decodeURI et decodeURIComponent déclenchent un URIError en présence d’échappements en pourcentage mal formés, comme %ZZ, ou de séquences d’octets qui ne codent pas un UTF-8 valide. encodeURI et encodeURIComponent le déclenchent en présence d’un substitut UTF-16 isolé. Les variantes avec Component traitent les composants individuels d’une URI ; les autres tiennent compte du rôle des caractères réservés dans une URI complète.

new URIError(message) crée un objet ; sa création seule ne déclenche pas d’exception. L’appel URIError(message) sans new crée également un objet. Pour déclencher votre propre erreur, utilisez throw new URIError(message). La propriété name vaut par défaut "URIError" ; le texte de message généré automatiquement dépend de l’implémentation.

Placez le décodage de données non fiables dans un bloc try...catch. Dans du code habituel exécuté dans un même realm, vérifiez error instanceof URIError et relancez les autres exceptions. Cette vérification peut échouer pour une erreur provenant d’un autre realm, par exemple d’une autre frame. L’exemple décode un texte valide et traite une séquence UTF-8 incomplète sans dépendre du texte du message.

Exemples

for (const input of ["hello%20world", "%E0%A4"]) {
  try {
    console.log(decodeURIComponent(input));
  } catch (error) {
    if (!(error instanceof URIError)) throw error;
    console.log(error.name);
  }
}

Résultat

hello world
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