Instruction try..catch..finally

 try {// ... bloc try ... } finally { // ... bloc finally ... } 
try {// ... bloc try ... } 
 catch(error [:ErrorType1]) // ... bloc catch ... } 
 [catch(error[:ErrorTypeN]) { // ... bloc catch ... }] 
 [finally { // ... bloc finally ... }]

Entoure un bloc de code dans lequel une erreur peut se produire et être traitée. Si du code figurant dans le bloc try renvoie une erreur (avec l'instruction throw), le contrôle passe au bloc catch, s'il existe, puis au bloc finally, s'il existe. Le bloc finally s'exécute toujours, qu'une erreur ait été renvoyée ou non. Si le code figurant dans le bloc try ne renvoie pas d'erreur (ce qui signifie que le bloc try se termine normalement), le code du bloc finally est toujours exécuté. Le bloc finally s'exécute même si le bloc try se termine par une instruction return.

Un bloc try doit être suivi par un bloc catch, un bloc finally ou les deux. Un bloc try peut comporter plusieurs blocs catch mais un seul bloc finally. Vous pouvez incorporer plusieurs blocs try et créer autant de niveaux que nécessaire.

Le paramètre error spécifié dans un gestionnaire catch doit être un simple identifiant tel que e, theException ou x. La variable d'un gestionnaire catch peut également être typée. Lorsqu'elles sont utilisées en conjonction avec plusieurs blocs catch, les erreurs typées permettent d'intercepter plusieurs types d'erreur à partir d'un bloc try unique.

Si l'exception renvoyée est un objet, le type correspond lorsque l'objet renvoyé constitue une sous-classe du type spécifié. Si une erreur de type spécifique est renvoyée, le bloc catch qui traite l'erreur correspondante s'exécute. Si l'exception renvoyée n'est pas du type spécifié, le bloc catch ne s'exécute pas et l'exception est renvoyée automatiquement du bloc try, à destination du gestionnaire catch correspondant.

Si une erreur est renvoyée au sein d'une fonction et si cette fonction n'inclut pas de gestionnaire catch, l'interpréteur ActionScript quitte alors cette fonction, ainsi que toute fonction appelante, jusqu'à ce qu'il détecte un bloc catch. Pendant ce processus, les gestionnaires finally sont appelés à tous les niveaux.

Paramètres

error:Object - Expression renvoyée par une instruction throw, en général une instance de la classe Error ou l'une de ses sous-classes.

Exemple

L'exemple suivant indique comment créer une instruction try..finally. Etant donné que l'exécution du code dans le bloc finally est garantie, ce code est généralement utilisé pour effectuer le nettoyage nécessaire après l'exécution d'un bloc try. Dans l'exemple suivant, setInterval() appelle une fonction toutes les 1000 millisecondes (1 seconde). Si une erreur se produit, elle est renvoyée et interceptée par le bloc catch. Le bloc finally est toujours exécuté, qu'une erreur se produise ou non. Etant donné que la méthode setInterval() est utilisée, clearInterval() doit être placé dans le bloc finally afin de s'assurer que l'intervalle est supprimé de la mémoire.

myFunction = function () { 
 trace("this is myFunction"); 
}; 
try { 
 myInterval = setInterval(this, "myFunction", 1000); 
 throw new Error("my error"); 
} 
catch (myError:Error) { 
 trace("error caught: "+myError); 
} 
finally { 
 clearInterval(myInterval); 
 trace("error is cleared"); 
}

Dans l'exemple suivant, le bloc finally est utilisé pour supprimer un objet ActionScript, qu'une erreur se soit produite ou non. Créez un nouveau fichier AS intitulé Account.as.

class Account { 
 var balance:Number = 1000; 
 function getAccountInfo():Number { 
 return (Math.round(Math.random() * 10) % 2); 
 } 
}

Dans le répertoire du fichier Account.as, créez un nouveau document AS ou FLA et entrez le code ActionScript suivant dans l'image 1 du scénario :

import Account; 
var account:Account = new Account();
try { 
 var returnVal = account.getAccountInfo(); 
 if (returnVal != 0) { 
 throw new Error("Error getting account information."); 
 } 
} 
finally { 
 if (account != null) { 
 delete account; 
 } 
}

L'exemple ci-dessous illustre une instruction try..catch. Le code inclus dans le bloc try est exécuté. Si une exception est renvoyée par du code inclus dans le bloc try, le contrôle passe au bloc catch qui affiche le message d'erreur dans un champ texte à l'aide de la méthode Error.toString().

Dans le répertoire du fichier Account.as, créez un nouveau document FLA et entrez le code ActionScript suivant dans l'image 1 du scénario :

import Account; 
var account:Account = new Account(); 
try { 
 var returnVal = account.getAccountInfo(); 
 if (returnVal != 0) { 
 throw new Error("Error getting account information."); 
 } 
 trace("success"); 
} 
catch (e) { 
 this.createTextField("status_txt", this.getNextHighestDepth(), 0, 0, 100, 22); 
 status_txt.autoSize = true; 
 status_txt.text = e.toString(); 
}

L'exemple suivant présente un bloc de code try en conjonction avec plusieurs blocs de code typés catch. Selon le type d'erreur qui s'est produite, le bloc de code try renvoie un type d'objet différent. Dans ce cas, myRecordSet est une occurrence d'une classe (hypothétique) intitulée RecordSet dont la méthode sortRows() peut renvoyer deux types d'erreurs, RecordSetException et MalformedRecord.

Dans l'exemple suivant, les objets RecordSetException et MalformedRecord sont des sous-classes de la classe Error. Chacune d'entre elles est définie dans son propre fichier de classe AS.

// Dans RecordSetException.as : 
class RecordSetException extends Error { 
 var message = "Record set exception occurred."; 
} 
// Dans MalformedRecord.as : 
class MalformedRecord extends Error { 
 var message = "Malformed record exception occurred."; 
}

Dans la méthode sortRows() de la classe RecordSet, l'un des objets d'erreur définis précédemment est renvoyé, en fonction du type d'exception rencontré. L'exemple suivant illustre l'aspect éventuel de ce code :

class RecordSet { 
 function sortRows() { 
 var returnVal:Number = randomNum(); 
 if (returnVal == 1) { 
 throw new RecordSetException(); 
 } 
 else if (returnVal == 2) { 
 throw new MalformedRecord(); 
 } 
 }
 function randomNum():Number { 
 return Math.round(Math.random() * 10) % 3; 
 }
}

Enfin, dans un autre fichier AS ou script FLA, le code suivant appelle la méthode sortRows() sur une occurrence de la classe RecordSet. Il définit les blocs catch de chaque type d'erreur renvoyé par sortRows()

import RecordSet; 
var myRecordSet:RecordSet = new RecordSet();
try { 
 myRecordSet.sortRows(); 
 trace("everything is fine"); 
} 
catch (e:RecordSetException) { 
 trace(e.toString()); 
} 
catch (e:MalformedRecord) { 
 trace(e.toString()); 
}

Instruction try..catch..finally

Paramètres

Exemple

Voir aussi