Comandos de la Consola JavaScript

La ventana Consola JavaScript de Visual Studio te permite usar comandos para enviar mensajes y realizar otras tareas. Para ver ejemplos del uso de esa ventana, consulte Inicio rápido: Depurar JavaScript mediante la consola. La información de este tema se refiere a aplicaciones de la Tienda Windows y la Tienda de Windows Phone con JavaScript. Para obtener información sobre los comandos de la consola compatibles en aplicaciones híbridas para varios dispositivos, consulte Depurar la aplicación. Para obtener información sobre el uso de la consola con herramientas de F12 de Internet Explorer, consulte este tema.

Si la ventana Consola JavaScript está cerrada, puedes abrirla durante la depuración en Visual Studio si eliges Depurar > Ventanas > Consola JavaScript.

Nota
Si la ventana no está disponible durante una sesión de depuración, asegúrese de que el tipo de depurador está establecido en Script en las propiedades de depuración del proyecto.

Comandos del objeto console

En esta tabla se muestra la sintaxis de los comandos del objeto console que puedes usar en la ventana Consola JavaScript o para enviar mensajes a la consola desde el código. Este objeto tiene varias formas que te permiten diferenciar, si quieres, los mensajes informativos de los mensajes de error.

Nota
Puedes usar la forma larga del comando window.console.[command] si tienes que evitar confusiones posibles con objetos locales cuyo nombre también sea console.

Comando	Descripción	Ejemplo
assert(expression, message)	Envía un mensaje si expression se evalúa como false.	console.assert((x == 1), "assert message: x != 1");
clear()	Borra mensajes de la ventana de consola, incluidos los mensajes de error de script, y también borra el script que aparece en la ventana de consola. No borra el script especificado en el indicador de entrada de la consola.	console.clear();
count(title)	Envía el número de veces que se llamó el comando count en la ventana de consola. Cada llamada a este comando se identifica de forma única mediante el parámetro title opcional. La entrada existente en la ventana de consola se identifica mediante el parámetro title (si existe) y se actualiza mediante el comando count. No se crea una nueva entrada. Requisitos: Visual Studio 2013	console.count(); console.count("inner loop");
debug(message)	Envía message a la ventana de consola. Este comando es idéntico a console.log. Los objetos que se pasan mediante el comando se convierten en un valor de cadena. Requisitos: Visual Studio 2013	console.debug("logging message");
dir(object)	Envía el objeto especificado a la ventana de consola y lo muestra en un visualizador de objeto. Puedes usar el visualizador para inspeccionar las propiedades en la ventana de consola.	console.dir(obj);
dirxml(object)	Envía el nodo XML object especificado a la ventana de consola y lo muestra como un árbol de nodos XML. Requisitos: Visual Studio 2013	console.dirxaml(xmlNode);
error(message)	Envía message a la ventana de consola. El texto del mensaje es de color rojo y va precedido de un símbolo de error. Los objetos que se pasan mediante el comando se convierten en un valor de cadena.	console.error("error message");
group(title)	Inicia una agrupación para los mensajes que se envían a la ventana de consola, y envía el parámetro title opcional como etiqueta de grupo. Es posible anidar los grupos y mostrarlos en una vista de árbol en la ventana de consola. Los comandos group* facilitan la visualización de la salida de la ventana de consola en algunos escenarios, como cuando se utiliza un modelo de componentes. Requisitos: Visual Studio 2013	console.log("This is the outer level"); console.group("Level 2 Header"); console.log("Level 2"); console.group(); console.log("Level 3"); console.warn("More of level 3"); console.groupEnd(); console.log("Back to level 2"); console.groupEnd(); console.debug("Back to the outer level");
groupCollapsed(title)	Inicia una agrupación para los mensajes que se envían a la ventana de consola, y envía el parámetro title opcional como etiqueta de grupo. De forma predeterminada, los grupos que se envían mediante groupCollapsed aparecen en una vista contraída. Es posible anidar los grupos y mostrarlos en una vista de árbol en la ventana de consola. Requisitos: Visual Studio 2013	Su uso es igual que el del comando group. Consulta el ejemplo para el comando group.
groupEnd()	Finaliza el grupo actual. Requisitos: Visual Studio 2013	Consulta el ejemplo para el comando group.
info(message)	Envía message a la ventana de consola. El mensaje va precedido de un símbolo de información.	console.info("info message"); Para ver más ejemplos, consulte Aplicar formato al resultado de console.log más adelante en este tema.
log(message)	Envía message a la ventana de consola. Si pasas un objeto, este comando lo envía a la ventana de la consola y lo muestra en un visualizador de objeto. Puedes usar el visualizador para inspeccionar las propiedades en la ventana de consola.	console.log("logging message");
msIsIndependentlyComposed(element)	Se utiliza en aplicaciones web. No se admite en aplicaciones de la Tienda con JavaScript.	No se admite.
profile(reportName)	Se utiliza en aplicaciones web. No se admite en aplicaciones de la Tienda con JavaScript.	No se admite.
profileEnd()	Se utiliza en aplicaciones web. No se admite en aplicaciones de la Tienda con JavaScript.	No se admite.
select(element)	Selecciona el parámetro HTML element especificado en el Explorador DOM. Requisitos: Visual Studio 2013	console.select(element);
time (name)	Inicia un temporizador identificado por el parámetro name opcional. Cuando se utiliza con console.timeEnd, calcula el tiempo transcurrido entre time y timeEnd, y envía el resultado (medido en ms) a la consola utilizando la cadena name como prefijo. Se utiliza para habilitar la instrumentación del código de la aplicación para medir el rendimiento. Requisitos: Visual Studio 2013	console.time("app start"); app.start(); console.timeEnd("app start");
timeEnd(name)	Detiene un temporizador identificado por el parámetro name opcional. Consulta el comando de la consola time. Requisitos: Visual Studio 2013	console.time("app start"); app.start(); console.timeEnd("app start");
trace()	Envía un seguimiento de la pila a la ventana de consola. Los datos de seguimiento incluyen la pila de llamadas completa e información como el nombre de archivo, el número de línea y el número de columna. Requisitos: Visual Studio 2013	console.trace();
warn(message)	Envía message a la ventana de consola, precedido de un símbolo de advertencia. Los objetos que se pasan mediante el comando se convierten en un valor de cadena.	console.warn("warning message");

Comandos varios

Estos comandos también están disponibles en la ventana Consola JavaScript.

Comando	Descripción	Ejemplo
$0, $1, $2, $3, $4	Devuelve el elemento especificado a la ventana de consola. $0 devuelve el elemento que está seleccionado en el Explorador DOM, $1 devuelve el elemento seleccionado anteriormente en el Explorador DOM y así sucesivamente, hasta el cuarto elemento anterior seleccionado.	$3
$(id)	Devuelve un elemento por su identificador. Es un comando de acceso directo para document.getElementById(id), donde id es una cadena que representa el identificador de elemento.	$("contenthost")
$$(selector)	Devuelve una matriz de elementos que coinciden con el selector especificado mediante la sintaxis del selector de CSS. Es un comando de acceso directo para document.querySelectorAll().	$$(".itemlist")
cd() cd(window)	Permite cambiar el contexto para la evaluación de la expresión desde la ventana predeterminada de nivel superior de la página hasta la ventana del marco especificado. Si se llama a cd() sin parámetros, se devuelve el contexto a la ventana de nivel superior.	cd(); cd(myframe);
select(element)	Selecciona el elemento especificado en el Explorador DOM.	select(document.getElementById("element")); select($("element")); select($1);
dir(object)	Devuelve un visualizador para el objeto especificado. Puedes usar el visualizador para inspeccionar las propiedades en la ventana de consola.	dir(obj);

Comprobar si existe un comando de consola

Puedes comprobar si existe un comando determinado antes de intentar utilizarlo. En este ejemplo se comprueba la existencia del comando console.log. Si console.log existe, el código lo llama.

if (console && console.log) {
    console.log("msg");
}

Examinar objetos en la ventana Consola JavaScript

Puedes interactuar con cualquier objeto que esté dentro del ámbito cuando utilices la ventana Consola JavaScript. Para inspeccionar un objeto que esté fuera del ámbito en la ventana de la consola, utiliza console.log , console.dir u otros comandos del código. También puede interactuar con el objeto desde la ventana de la consola mientras esté dentro del ámbito si establece un punto de interrupción en el código (Punto de interrupción > Insertar punto de interrupción).

Aplicar formato al resultado de console.log

Si pasas varios argumentos a console.log, la consola los tratará como una matriz y concatenará el resultado.

var user = new Object();
user.first = "Fred";
user.last = "Smith";

console.log(user.first, user.last);
// Output:
// Fred Smith

console.log también admite patrones de sustitución "printf" para aplicar formato al resultado. Si usas patrones de sustitución en el primer argumento, los demás argumentos se emplearán para sustituir los patrones especificados en el orden en que se utilicen.

Se admiten los siguientes patrones de sustitución:

• %s - cadena
  %i - entero
  %d - entero
  %f - flotante
  %o - objeto
  %b - binario
  %x - hexadecimal
  %e - exponente

Aquí se proporcionan algunos ejemplos del empleo de patrones de sustitución en console.log:

var user = new Object();
user.first = "Fred";
user.last = "Smith";
user.age = 10.01;
console.log("Hi, %s %s!", user.first, user.last);
console.log("%s is %i years old!", user.first, user.age);
console.log("%s is %f years old!", user.first, user.age);

// Output:
// Hi, Fred Smith!
// Fred is 10 years old!
// Fred is 10.01 years old!

Vea también

Conceptos

Inicio rápido: Depurar JavaScript mediante la consola

Inicio rápido: Depurar HTML y CSS