URIError

L'objet URIError représente une erreur renvoyée lorsqu'une fonction de manipulation d'URI a été utilisée de façon inappropriée.

Syntaxe

new URIError([message[, nomFichier[, numéroLigne]]])

Paramètres

message
Ce paramètre est optionnel. Il correspond à un chaîne de caractères décrivant l'erreur de façon compréhensible.
nomFichier
Ce paramètre est optionnel. Il correspond au nom du fichier contenant le code à l'origine de l'exception.
numéroLigne
Ce paramètre est optionnel. Il correspond au numéro de la ligne dans le fichier contenant le code qui a entraîné l'exception.

Description

Une exception URIError est lancée lorsque les fonctions de gestion d'URI reçoivent une URI mal formée.

Propriétés

URIError.prototype
Cette propriété permet d'ajouter des propriétés à un objet URIError.

Méthodes

L'objet global URIError ne contient aucune méthode qui lui soit directement attachée. Cependant, il hérite de certaines méthodes grâce à sa chaîne de prototypes.

Instances d'URIError

Propriétés

URIError.prototype.constructor
Cette propriété définit la fonction qui a créé le prototype de l'instance.
URIError.prototype.message
Un message décrivant l'erreur. Bien qu'ECMA-262 spécifie qu'URIError devrait avoir une propriété message en propre, SpiderMonkey lui fait hériter de Error.prototype.message.
URIError.prototype.name
Un nom d'erreur. Héritée depuis Error.
URIError.prototype.fileName
Le chemin vers le fichier qui a causé l'erreur. Héritée depuis Error.
URIError.prototype.lineNumber
Le numéro de la ligne dans le fichier qui a causé l'erreur. Héritée depuis Error.
URIError.prototype.columnNumber
Le numéro de colonne (la position dans la ligne) dans le fichier qui a causé l'erreur. Héritée depuis Error.
URIError.prototype.stack
La pile d'appels ayant mené à l'erreur (stack trace). Héritée de Error.

Méthodes

Bien que l'objet prototype pour URIError ne contienne pas de méthode qui lui soit directement rattachée, les instances d'URIError héritent de certaines méthodes grâce à la chaîne de prototypes.

Exemples

Intercepter une exception URIError

try {
  decodeURIComponent('%');
} catch (e) {
  console.log(e instanceof URIError); // true
  console.log(e.message);             // "malformed URI sequence"
  console.log(e.name);                // "URIError"
  console.log(e.fileName);            // "Scratchpad/1"
  console.log(e.lineNumber);          // 2
  console.log(e.columnNumber);        // 2
  console.log(e.stack);               // "@Scratchpad/2:2:3\n"
}

Créer une exception URIError

try {
  throw new URIError('Coucou', 'monFichier.js', 10);
} catch (e) {
  console.log(e instanceof URIError); // true
  console.log(e.message);             // "Coucou"
  console.log(e.name);                // "URIError"
  console.log(e.fileName);            // "monFichier.js"
  console.log(e.lineNumber);          // 10
  console.log(e.columnNumber);        // 0
  console.log(e.stack);               // "@Scratchpad/2:2:9\n"
}

Spécifications

Spécification Statut Commentaires
ECMAScript 3rd Edition (ECMA-262)
La définition de 'URIError' dans cette spécification.
Standard Définition initiale.
ECMAScript 5.1 (ECMA-262)
La définition de 'URIError' dans cette spécification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'URIError' dans cette spécification.
Standard  
ECMAScript 2016 Draft (7th Edition, ECMA-262)
La définition de 'URIError' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,