PackageNiveau supérieur
Classepublic dynamic class Error
HéritageError Inheritance Object
Sous-classes ArgumentError, DefinitionError, DRMManagerError, EvalError, IllegalOperationError, InvalidSWFError, IOError, MemoryError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SQLError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

La classe Error contient des informations sur une erreur survenue dans un script. Lorsque vous développez des applications ActionScript 3.0, une boîte de dialogue indique les exceptions de type Error ou associées à une sous-classe si vous exécutez le code compilé dans la version de débogage de Flash Player, pour vous aider à corriger le code. Vous pouvez créer un objet Error à l'aide de la fonction constructeur Error. En général, vous générez un nouvel objet Error à partir d'un bloc de code try, qui est ensuite détecté par un bloc de code catch ou finally.

Vous pouvez également créer une sous-classe de la classe Error et générer des occurrences de cette sous-classe.

Consulter les exemples

Voir aussi

Utilisation des versions de débogage de Flash Player et AIR
Création de classes d'erreur personnalisées
Réponse à des événements d'erreur et au statut


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  errorID : int
[lecture seule] Contient le numéro de référence associé au message d'erreur spécifique.
Error
  message : String
Contient le message associé à l'objet Error.
Error
  name : String
Contient le nom de l'objet Error.
Error
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
Méthodes publiques
 MéthodeDéfini par
  
Error(message:String = "", id:int = 0)
Crée un nouvel objet Error.
Error
  
Renvoie la pile d'appels d'une erreur sous la forme d'une chaîne lors de la construction de l'erreur (version de débogage de Flash Player et application de débogage du lanceur AIR seulement) ; renvoie la valeur null lorsque ni la version de débogage de Flash Player ni l'application de débogage du lanceur AIR n'est utilisée.
Error
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
  
Renvoie la chaîne "Error" par défaut ou la valeur contenue dans la propriété Error.message, si elle est définie.
Error
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails de la propriété
errorIDpropriété
errorID:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Contient le numéro de référence associé au message d'erreur spécifique. Pour un objet Error personnalisé, ce nombre correspond à la valeur du paramètre id fourni dans le constructeur.



Implémentation
    public function get errorID():int
messagepropriété 
public var message:String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Contient le message associé à l'objet Error. Par défaut, la valeur de cette propriété est « Error ». Vous pouvez spécifier une propriété message lorsque vous créez un objet Error en transmettant la chaîne d'erreur à la fonction constructeur Error.

Voir aussi

namepropriété 
public var name:String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Contient le nom de l'objet Error. Par défaut, la valeur de cette propriété est « Error ».

Voir aussi

Détails du constructeur
Error()Constructeur
public function Error(message:String = "", id:int = 0)

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Crée un nouvel objet Error. Si message est spécifié, sa valeur est affectée à la propriété Error.message de l'objet.

Paramètres
message:String (default = "") — Chaîne associée à l'objet Error. Ce paramètre est facultatif.
 
id:int (default = 0) — Numéro de référence à associer au message d'erreur spécifique.

Voir aussi


Exemple

L'exemple suivant crée un nouvel objet Error, err puis, à l'aide du constructeur Error(), affecte la chaîne "New Error Message" à err.
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message
Détails de la méthode
getStackTrace()méthode
public function getStackTrace():String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Renvoie la pile d'appels d'une erreur sous la forme d'une chaîne lors de la construction de l'erreur (version de débogage de Flash Player et application de débogage du lanceur AIR seulement) ; renvoie la valeur null lorsque ni la version de débogage de Flash Player ni l'application de débogage du lanceur AIR n'est utilisée. Comme indiqué dans l'exemple suivant, la première ligne de la valeur renvoyée est une chaîne qui représente l'objet d'exception, suivi par les éléments de la pile de suivi :

TypeError: null cannot be converted to an object
      at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
      at com.xyz.OrderEntry.init(OrderEntry.as:200)
      at com.xyz.OrderEntry.$construct(OrderEntry.as:148)

Valeur renvoyée
String — Représentation sous forme de chaîne de la pile d'appels.
toString()méthode 
override public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Renvoie la chaîne "Error" par défaut ou la valeur contenue dans la propriété Error.message, si elle est définie.

Valeur renvoyée
String — Message d'erreur.

Voir aussi


Exemple

L'exemple suivant crée un nouvel objet Error, err puis, à l'aide du constructeur Error(), affecte la chaîne "New Error Message" à err. Enfin, la propriété message est définie sur "Another New Error Message", qui remplace "New Error Message".
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message
Exemples Utilisation des exemples
ErrorExample.as

L'exemple suivant exploite la classe ErrorExample pour indiquer comment générer une erreur personnalisée. Cette opération s'accomplit de la façon suivante :
  1. Une variable locale, nullArray, de type Array est déclaré. Vous remarquerez qu'aucun objet Array n'est créé.
  2. Le constructeur tente de charger une valeur dans le tableau non initialisé en utilisant la méthode push() au sein d 'un segment de code de traitement des erreurs qui intercepte une erreur personnalisée à l'aide de la classe CustomError, qui étend Error.
  3. Lorsque CustomError est renvoyé, le constructeur l'intercepte, puis renvoie un message d'erreur à l'aide de l'instruction trace().
package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}