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 deError.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
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