La classe Console définit cinq méthodes :
log()
,
warn()
,
info()
,
error()
et
dump()
.
Les méthodes
log()
,
warn()
,
info()
et
error()
permettent d’envoyer un objet à l’onglet Console. La méthode
log()
est la plus élémentaire d’entre elles. Le code suivant envoie un objet simple, représenté par la variable
test
, à l’onglet Console :
var test = "hello";
air.Introspector.Console.log(test);
Il est cependant plus judicieux d’envoyer un objet complexe à l’onglet Console. La page HTML suivante, par exemple, contient un bouton (
btn1
) qui appelle une fonction qui envoie l’objet lui-même à l’onglet Console :
<html>
<head>
<title>Source Viewer Sample</title>
<script type="text/javascript" src="scripts/AIRIntrospector.js"></script>
<script type="text/javascript">
function logBtn()
{
var button1 = document.getElementById("btn1");
air.Introspector.Console.log(button1);
}
</script>
</head>
<body>
<p>Click to view the button object in the Console.</p>
<input type="button" id="btn1"
onclick="logBtn()"
value="Log" />
</body>
</html>
Lorsque vous cliquez sur le bouton, l’onglet Console affiche l’objet btn1 et, et vous pouvez développer l’arborescence de celui-ci pour inspecter ses propriétés :
Vous pouvez modifier une propriété de l’objet en cliquant sur le listing à droite du nom de la propriété et en modifiant le texte correspondant.
Les méthodes
info()
,
error()
et
warn()
sont similaires à la méthode
log()
. Toutefois, lorsque vous les appelez, une icône s’affiche au début de la ligne sur la console :
|
Méthode
|
Icône
|
|
info()
|
|
|
error()
|
|
|
warn()
|
|
Les méthodes
log()
,
warn()
,
info()
et
error()
se contentent d’envoyer une référence à un objet ; par conséquent, seules les propriétés présentes au moment de l’affichage sont disponibles. Pour sérialiser l’objet lui-même, utilisez la méthode
dump()
. Cette méthode gère deux paramètres :
|
Paramètre
|
Description
|
|
dumpObject
|
Objet à sérialiser.
|
|
levels
|
Nombre maximal de niveaux à examiner dans l’arborescence de l’objet (outre le niveau racine). La valeur par défaut est 1 (autrement dit, un niveau sous le niveau racine de l’arborescence est affiché). Ce paramètre est facultatif.
|
L’appel de la méthode
dump()
sérialise un objet avant de l’envoyer à l’onglet Console ; vous ne pouvez donc pas modifier ses propriétés. Considérons par exemple le code qui suit :
var testObject = new Object();
testObject.foo = "foo";
testObject.bar = 234;
air.Introspector.Console.dump(testObject);
Lorsque vous exécutez ce code, l’objet
testObject
et ses propriétés s’affichent sur la console, mais il vous est impossible de modifier la valeur des propriétés.
