La clase Console define cinco métodos:
log()
,
warn()
,
info()
,
error()
y
dump()
.
Los métodos
log()
,
warn()
,
info()
, and
error()
permiten enviar un objeto a la ficha Console (Consola). El método más básico es
log()
. El siguiente código envía un objeto simple, representado mediante la variable
test
, a la ficha Console (Consola):
var test = "hello";
air.Introspector.Console.log(test);
No obstante, resulta más útil enviar un objeto complejo a la ficha. Por ejemplo, la siguiente página HTML incluye un botón (
btn1
) que llama a una función que, a su vez, envía el propio objeto del botón a la ficha Console (Consola):
<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>
Cuando se hace clic en el botón, la ficha Console (Consola) muestra el objeto btn1 y se puede expandir la vista de árbol del objeto para inspeccionar sus propiedades:
Se puede editar una propiedad del objeto haciendo clic en la lista situada a la derecha del nombre de la propiedad y modificando el listado de texto.
Los métodos
info()
,
error()
y
warn()
son similares al método
log()
. Sin embargo, cuando se llama a estos métodos, la consola muestra un icono al principio de la línea:
Método
|
Icono
|
info()
|
|
error()
|
|
warn()
|
|
Los métodos
log()
,
warn()
,
info()
y
error()
envían una referencia solo a un objeto real, por lo que las propiedades disponibles son las que se muestran en el momento de la visualización. Si desea serializar el objeto real, utilice el método
dump()
. El método cuenta con dos parámetros:
Parámetro
|
Descripción
|
dumpObject
|
Objeto que se va a serializar.
|
levels
|
Número máximo de niveles que se examinarán en el árbol del objeto (además del nivel de raíz). El valor predeterminado es 1 (lo que significa que se muestra un nivel superior al nivel de raíz del árbol). Este parámetro es opcional.
|
Al llamar al método
dump()
se serializa un objeto antes de enviarlo a la ficha Console (Consola), por lo que no se pueden editar las propiedades de los objetos. Por ejemplo, considérese el fragmento de código siguiente:
var testObject = new Object();
testObject.foo = "foo";
testObject.bar = 234;
air.Introspector.Console.dump(testObject);
Cuando se ejecuta este código, la consola muestra el objeto
testObject
y sus propiedades, pero no se pueden editar los valores de las propiedades en la consola.