Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
Niveau supérieur 

Error  - AS3

PackageNiveau supérieur
Classepublic dynamic class Error
HéritageError Inheritance Object
Sous-classes ArgumentError, AugmentedError, AutomationError, CollectionViewError, ComplexCyclicDependencyError, Conflict, ConstraintError, CursorError, DataServiceError, DefinitionError, DRMManagerError, EvalError, ExpressionError, ExpressionEvaluationError, ExpressionValidationError, Fault, FormBridgeError, FunctionSequenceError, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MediaError, MemoryError, MessagingError, MetricError, NoDataAvailableError, PermissionError, PersistenceError, PersistenceError, ProxyServiceError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SimpleCyclicDependencyError, SortError, SQLError, StackOverflowError, SyncManagerError, SyntaxError, TypeError, UnresolvedConflictsError, URIError, VerifyError, VideoError, VideoError

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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 d’un moteur d’exécution de Flash 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.

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

Plus d’exemples

Informations complémentaires



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
Méthodes publiques
 MéthodeDéfini par
  
Error(message:String = "", id:int = 0)
Crée un nouvel objet Error.
Error
  
Renvoie la pile d’appel pour générer une erreur au moment de la construction de l’erreur en tant que chaîne.
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
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
[override] 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é

errorID

propriété
errorID:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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

message

propriété 
public var message:String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

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.

Eléments de l’API associés

name

propriété 
public var name:String

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Contient le nom de l’objet Error. Par défaut, la valeur de cette propriété est "Error".

Eléments de l’API associés

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, Flash Lite 4

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.

Eléments de l’API associés


Exemple  ( Comment utiliser cet 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, Flash Lite 4

Renvoie la pile d’appel pour générer une erreur au moment de la construction de l’erreur en tant que chaîne. 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 trace de la pile :

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]
        

La liste ci-dessus illustre la valeur de cette méthode lorsqu’elle est appelée dans une version de débogage de Flash Player ou lorsque le code est en cours d’exécution dans l’application de débogage du lanceur AIR (ADL). Lorsque le code est exécuté dans une version commerciale de Flash Player ou d’AIR, la trace de la pile est fournie sans le chemin d’accès au fichier et les informations sur les numéros de ligne, comme dans l’exemple suivant :

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()
        

Pour Flash Player 11.4 et les versions antérieures et AIR 3.4 et les versions antérieures, les traces de la pile sont uniquement disponibles lorsque le code est exécuté dans la version de débogage de Flash Player ou l’application de débogage du lanceur AIR (ADL). Dans les versions du moteur d’exécution qui ne sont pas des versions de débogage, l’appel de cette méthode renvoie null.

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, Flash Lite 4

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.

Eléments de l’API associés


Exemple  ( Comment utiliser cet 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
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);
    }
}




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.