La classe Console definisce cinque metodi:
log()
,
warn()
,
info()
,
error()
e
dump()
.
I metodi
log()
,
warn()
,
info()
e
error()
permettono di inviare un oggetto alla scheda Console. Il metodo più semplice tra questi è
log()
. Il codice seguente consente di inviare un oggetto semplice, rappresentato dalla variabile
test
, alla scheda Console:
var test = "hello";
air.Introspector.Console.log(test);
È tuttavia più utile inviare un oggetto complesso alla scheda Console. La pagina HTML seguente ad esempio include un pulsante (
btn1
) che chiama una funzione per inviare l'oggetto pulsante stesso alla scheda 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>
Quando fate clic sul pulsante, nella scheda Console viene visualizzato l'oggetto btn1 e potete espandere la visualizzazione struttura dell'oggetto per ispezionarne le proprietà:
Potete modificare una proprietà dell'oggetto facendo clic sul listato a destra del nome della proprietà e modificando il testo del listato.
I metodi
info()
,
error()
e
warn()
sono analoghi al metodo
log()
. Quando chiamate questi metodi, tuttavia, all'inizio della riga nella Console viene visualizzata un'icona:
Metodo
|
Icona
|
info()
|
|
error()
|
|
warn()
|
|
I metodi
log()
,
warn()
,
info()
ed
error()
consentono di inviare un riferimento solo a un oggetto effettivo, pertanto le proprietà disponibili sono quelle presenti al momento della visualizzazione. Se desiderate serializzare l'oggetto effettivo, utilizzate il metodo
dump()
. Il metodo presenta due parametri:
Parametro
|
Descrizione
|
dumpObject
|
L'oggetto da serializzare.
|
levels
|
Il numero massimo di livelli da esaminare nella struttura dell'oggetto (in aggiunta al livello principale). Il valore predefinito è 1 (che indica che viene mostrato un livello sotto quello principale). Questo parametro è opzionale.
|
La chiamata del metodo
dump()
consente di serializzare un oggetto prima di inviarlo alla scheda Console affinché non sia possibile modificarne le proprietà. Consideriamo l'esempio del codice seguente:
var testObject = new Object();
testObject.foo = "foo";
testObject.bar = 234;
air.Introspector.Console.dump(testObject);
Quando eseguite questo codice, nella Console viene visualizzato l'oggetto
testObject
con le relative proprietà, ma non potete modificare i valori delle proprietà nella Console.