$script.pushErrors
Description
Push le buffer d'erreurs.
Cela consiste à faire un snapshot de la liste d'erreurs actuelle en vue
d'une restauration ultérieure. On utilisera par exemple cette méthode si
on souhaite effectuer un traitement susceptible de générer une erreur et
que l'on ne souhaite pas polluer la liste d'erreur actuelle.
La liste d'erreurs existantes avant le push peut être restaurée au
moyen de la méthode $script.popErrors.
Syntaxe
$script.pushErrors( [ keep ] )
Paramètres
keep boolean-
Flag true/false indiquant si on souhaite que les erreurs déjà
présentes dans le buffer soient conservées. Si le paramètre est
true, cela signifie que la méthode effectue un snapshot du buffer.
Si le paramètre est false, cela signifie que les erreurs du buffer
actuel sont mises de côté en attendant le pop.
Le paramètre est false par défaut.
Retour
Retourne le nombre d'erreurs "pushées".
Exemple
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20 | $script.error("Houston, we have a problem");
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "1: Application `ve`: Houston, we have a problem"
// exemple avec option "keep"
$script.pushErrors(true);
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "1: Application `ve`: Houston, we have a problem"
$logger.error("Other error (keep=true)");
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "2: Application `ve`: Other error (keep=true)"
$script.popErrors();
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "1: Application `ve`: Houston, we have a problem"
// exemple sans option "keep"
$script.pushErrors(false);
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "0: "
$logger.error("Other error (keep=false)");
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "1: Application `ve`: Other error (keep=false)"
$script.popErrors();
$logger.info($script.getErrorCount() & ": " & $script.getLastError()); // affiche "1: Application `ve`: Houston, we have a problem"
|