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 Latest Draft (ECMA-262)
La définition de 'URIError' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

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