Partilhar via

Comandos do Console JavaScript

  • Artigo

Aplica-se ao Windows e Windows Phone

Você pode usar comandos para enviar mensagens e executar outras tarefas na janela Console do JavaScript do Visual Studio. Para ver exemplos que mostram como usar essa janela, consulte Guia de início rápido: depurar o JavaScript usando o console. As informações deste tópico se aplicam a aplicativos da Windows Store e da Windows Phone Store usando o JavaScript. Para mais detalhes sobre os comandos com suporte do console em aplicativos híbridos multidispositivos, consulte Debug your app (Depurar seu aplicativo). Para saber mais sobre como usar o console nas ferramentas F12 do Internet Explorer, consulte este tópico.

Se a janela Console do JavaScript estiver fechada, você poderá abri-la durante a depuração no Visual Studio clicando em Depurar > Windows > Console do JavaScript.

Dica

Se a janela não estiver disponível durante uma sessão de depuração, certifique-se de que o tipo de depurador esteja definido como Script nas propriedades de Depuração do projeto.

Comandos do objeto console

Esta tabela mostra a sintaxe dos comandos de objeto do console que você pode usar na janela do Console do JavaScript ou para enviar mensagens de seu código para o console. Esse objeto oferece diversos formatos para que você possa distinguir entre mensagens informativas e mensagens de erro, se desejar.

Dica

Você pode usar o formato de comando mais longo, window.console.[command], se precisar evitar uma possível confusão com objetos locais chamados console.

Comando

Descrição

Exemplo

assert(expression, message)

Envia uma mensagem se expression for avaliada como false.

console.assert((x == 1), "assert message: x != 1");

clear()

Limpa as mensagens da janela do console, incluindo mensagens de erro de script, e limpa também o script exibido na janela do console. Não limpa o script inserido no prompt de entrada do console.

console.clear();

count(title)

Envia o número de vezes que o comando count foi chamado para a janela do console. Cada chamada do comando count é identificada exclusivamente pelo titleopcional.

A entrada existente na janela do console é identificada pelo parâmetro title (se presente) e atualizada pelo comando count. Não é criada uma nova entrada.

Requisitos:

Visual Studio 2013

console.count();

console.count("inner loop");

debug(message)

Envia message para a janela do console.

Esse comando é idêntico a console.log.

Os objetos transmitidos usando o comando são convertidos em um valor de cadeia de caracteres.

Requisitos:

Visual Studio 2013

console.debug("logging message");

dir(object)

Envia o objeto especificado para a janela do console e o exibe em um visualizador de objetos. Você pode usar o visualizador para inspecionar propriedades na janela do console.

console.dir(obj);

dirxml(object)

Envia o nó XML object especificado para a janela do console e o exibe como uma árvore de nós XML.

Requisitos:

Visual Studio 2013

console.dirxaml(xmlNode);

error(message)

Envia message para a janela do console. O texto da mensagem está em vermelho e antecedido por um símbolo de erro.

Os objetos transmitidos usando o comando são convertidos em um valor de cadeia de caracteres.

console.error("error message");

group(title)

Inicia um agrupamento das mensagens enviadas à janela do console e envia o title opcional como um rótulo de grupo. Os grupos podem ser aninhados e aparecer em um modo de exibição de árvore na janela do console.

Os comandos group* podem facilitar a exibição da saída da janela do console em alguns cenários, como quando um modelo de componente está em uso.

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 um agrupamento das mensagens enviadas à janela do console e envia o title opcional como um rótulo de grupo. Os grupos enviados usando groupCollapsed aparecem em uma exibição recolhida por padrão. Os grupos podem ser aninhados e aparecer em um modo de exibição de árvore na janela do console.

Requisitos:

Visual Studio 2013

O uso é o mesmo do comando group.

Consulte o exemplo do comando group.

groupEnd()

Encerra o grupo atual.

Requisitos:

Visual Studio 2013

Consulte o exemplo do comando group.

info(message)

Envia message para a janela do console. A mensagem é prefaciada por um símbolo de informação.

console.info("info message");

Para ver mais exemplos, consulte Formatação da saída do console.log mais adiante neste tópico.

log(message)

Envia message para a janela do console.

Se você transmitir um objeto, este comando o enviará para a janela do console e o exibirá num visualizador de objeto. Você pode usar o visualizador para inspecionar propriedades na janela do console.

console.log("logging message");

msIsIndependentlyComposed(element)

Usado em aplicativos da Web. Sem suporte em aplicativos da Store usando JavaScript.

Sem suporte.

profile(reportName)

Usado em aplicativos da Web. Sem suporte em aplicativos da Store usando JavaScript.

Sem suporte.

profileEnd()

Usado em aplicativos da Web. Sem suporte em aplicativos da Store usando JavaScript.

Sem suporte.

select(element)

Seleciona o element HTML especificado no Explorador do DOM.

Requisitos:

Visual Studio 2013

console.select(element);

time (name)

Inicia um temporizador que é identificado pelo parâmetro name opcional. Quando usado com console.timeEnd, calcula o tempo decorrido entre time e timeEnd e envia o resultado (medido em ms) ao console usando a cadeia de caracteres name como prefixo. Usado para habilitar a instrumentação de código do aplicativo para medir o desempenho.

Requisitos:

Visual Studio 2013

console.time("app start"); app.start(); console.timeEnd("app start");

timeEnd(name)

Interrompe um temporizador que é identificado pelo parâmetro name opcional. Consulte o comando time do console.

Requisitos:

Visual Studio 2013

console.time("app start"); app.start(); console.timeEnd("app start");

trace()

Envia um rastreamento de pilha à janela do console. O rastreamento inclui a pilha de chamadas completa e informações como o nome do arquivo, o número da linha e o número da coluna.

Requisitos:

Visual Studio 2013

console.trace();

warn(message)

Envia message para a janela do console, prefaciada por um símbolo de aviso.

Os objetos transmitidos usando o comando são convertidos em um valor de cadeia de caracteres.

console.warn("warning message");

Comandos variados

Esses comandos também estão disponíveis na janela Console do JavaScript.

Comando

Descrição

Exemplo

$0, $1, $2, $3, $4

Retorna o elemento especificado para a janela do console. $0 retorna o elemento selecionado atualmente no Explorador do DOM, $1 retorna o elemento selecionado anteriormente no Explorador do DOM e assim por diante, até o quarto elemento selecionado anteriormente.

$3

$(id)

Retorna um elemento por ID. Este é um comando de atalho para document.getElementById(id), onde id é uma cadeia de caracteres que representa a ID do elemento.

$("contenthost")

$$(selector)

Retorna uma matriz de elementos que correspondem ao seletor especificado usando a sintaxe do seletor de CSS. Este é um comando de atalho para document.querySelectorAll().

$$(".itemlist")

cd()

cd(window)

Permite que você altere o contexto de avaliação da expressão, da janela de nível superior padrão da página para a janela do quadro especificado. Chamar cd() sem parâmetros reverte o contexto para a janela de nível superior.

cd();

cd(myframe);

select(element)

Seleciona o elemento especificado no Explorador do DOM.

select(document.getElementById("element"));

select($("element"));

select($1);

dir(object)

Retorna um visualizador para o objeto especificado. Você pode usar o visualizador para inspecionar propriedades na janela do console.

dir(obj);

Verificando se um comando do console existe

Você pode verificar se um comando específico existe antes de tentar usá-lo. Este exemplo verifica a existência do comando console.log. Se console.log existir, o código irá chamá-lo.

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

Examinando objetos na janela Console do JavaScript

Você pode interagir com qualquer objeto que esteja no escopo usando a janela Console do JavaScript. Para inspecionar um objeto fora do escopo na janela do console, use console.log , console.dir ou outros comandos do seu código. Como alternativa, você pode interagir com o objeto da janela do console, enquanto está no escopo, definindo um ponto de interrupção no seu código (Ponto de interrupção > Inserir ponto de interrupção).

Formatação da saída do console.log

Se você transmitir diversos argumentos para console.log, o console os tratará como uma matriz e concatenará a saída.

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

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

console.log também oferece suporte a padrões de substituição "printf" para a formatação da saída. Se você usar padrões de substituição no primeiro argumento, outros argumentos serão usados para substituir os padrões especificados na ordem em que foram usados.

Há suporte para os seguintes padrões de substituição:

  • %s - cadeia de caracteres
    %i - inteiro
    %d - inteiro
    %f - flutuação
    %o - objeto
    %b - binário
    %x - hexadecimal
    %e - expoente

Estes são alguns exemplos de como usar padrões de substituição no 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!

Consulte também

Conceitos

Guia de início rápido: depurar o JavaScript usando o console

Guia de início rápido: depurar HTML e CSS