Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Plus d’exemples
Utilisation des instructions try..catch..finally
Création de classes d’erreur personnalisées
Réponse à des événements et à l’état d’erreur
Exemple de gestion des erreurs : application CustomErrors
Informations complémentaires
Gestion des erreurs dans ActionScript 3.0
Eléments de gestion des erreurs ActionScript 3.0
Stratégies de gestion des erreurs
Comparaison des classes Error
Classes Error de base
Propriété | Défini par | ||
---|---|---|---|
constructor : 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éthode | Défini par | ||
---|---|---|---|
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 | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
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 | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
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
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.
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 )
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
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
.
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.
String — Message d’erreur.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
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
pour indiquer comment générer une erreur personnalisée. Cette opération s’accomplit de la façon suivante :
- Une variable locale,
nullArray
, de type Array est déclaré. Vous remarquerez qu’aucun objet Array n’est créé. - 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 classeCustomError
, qui étendError
. - 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); } }
Tue Jun 12 2018, 09:30 AM Z