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 (en-US): 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 (ECMA-262) La définition de 'URIError' dans cette spécification.	Standard évolutif

Compatibilité des navigateurs

BCD tables only load in the browser