mozilla
Vos résultats de recherche

    URIError

    Résumé

    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
    Troisième édition d'ECMAScript. Standard Définition initiale.
    ECMAScript 5.1 (ECMA-262)
    La définition de 'URIError' dans cette spécification.
    Standard  
    ECMAScript 6 (ECMA-262)
    La définition de 'URIError' dans cette spécification.
    Draft  

    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

    Contributors to this page: SphinxKnight
    Dernière mise à jour par : SphinxKnight,