| 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 ou finally.
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 | ||
![]() | prototype : Object [statique]
Référence à l’objet prototype d’un objet de classe ou fonction. | Object | |
| Méthode | Défini par | ||
|---|---|---|---|
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 | ||
![]() |
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():intmessage | 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’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)
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);
}
}
Wed Apr 11 2012, 05:37 AM -07:00
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées