Console

Mtodos

console.assert(expression, object[, object...])

Emite uma mensagem e traa a sequncia de operaes at o primeiro argumento for falso.

console.count([label])

Mostra o nmero de vezes que esta linha foi chamada com a label fornecida.

console.debug(object[, object...])

Um atalho para log(); que foi adicionado para melhorar a compatibilidade de pginas j existentes que utilizavam debug(). Porm, ao invs destes comandos voc deve utilizar console.log().

console.dir(object)

Exibe uma listagem interativa das propriedades de um objeto JavaScript especificado. Esta listagem permite a voc expandir o objeto para visualizar o contedo de objetos filhos.

console.error(object[, object...])

Emite uma mensagem de erro. Voc pode usar substituio de string e outros argumentos adicionais com este mtodo. Consulte Uso de substituio de string.

console.exception(object[, object...])

Um atalho para error();

console.group(object[, object...])

Cria um novo grupo em linha e recua todas as mensagens seguintes para um nvel de indentao superior. Para voltar um nvel, utilize groupEnd(). Consulte Uso de grupos no console.

console.groupCollapsed(object[, object...])

Cria um novo grupo em linha e recua todas as mensagens seguintes para um nvel de indentao superior; ao contrrio de group(), o grupo em linha comea recolhido. Para revelar seu contedo, basta clicar no boto de revelao para expand-lo. Para recuar um nvel, utilize groupEnd(). Consulte Uso de grupos no console.

console.groupEnd()

Sai do grupo em linha atual. Veja Uso de grupos no console.

console.info(object[, object...])

Informaes de registro. Voc pode utilizar substituio de string e outros argumentos com este mtodo. Consulte Uso de substituio de string.

console.log(object[, object...])

Utilizado para a emisso de informaes de registro em geral. Voc pode utilizar substituio de string e outros argumentos com este mtodo. Consulte Uso de substituio de string.

console.profile( [profileLabel] )

Inicia o JavaScript profiler. Voc pode especificar qualquer label opcional para o perfil.

console.profileEnd()

Interrompe o profiler. Voc pode ver o profile resultante no JavaScript profiler.

Console.table()

Exibe dados, como objeto e array, como uma tabela.

console.time(label)

Inicia um contador de tempo com o nome especificado no parmetro label. At 10.000 contadores de tempo podem ser rodados por pgina.

console.timeEnd(label)

Interrompe o contador de tempo especificado e emite o tempo e registros do contador de tempo em milisegundos desde o seu incio. Veja Contadores de Tempo.

console.trace()

Emite um traado de pilha. See Traados de pilha.

console.warn(object[, object...])

Emite uma mensagem de alerta. Voc pode utilizar substituio de string e argumentos adicionais com este mtodo. Veja Uso de substituio de string.

Uso

Output de texto para o console

A utilizao mais frequente do console realizar o log de texto e de outros dados. H quatro categorias de output que podem ser geradas, utilizando os mtodos console.log(), console.info(), console.warn() e o console.error(). Cada um destes resultam em outputs que possuem estilos diferentes no log, e voc pode utilizar os controles de filtragem fornecidos pelo navegador para ver apenas os outputs que lhe interessam.

H duas maneiros da utilizar cada um dos mtodos de outuput. Voc pode simplemente passar uma lista dos objetos cuja representao em string ser concatenadas em uma string e ento realizar o output para o console, ou voc pode passar uma string contendo zero ou mais substituies de strings seguidas por uma lista de objetos para serem utilizados na substituio.

Output de um nico objeto

A forma mais simples de utilizar os mtodos de log realizar o output de um nico objeto:

var algumObjeto = { str: "Algum texto", id: 5 };
console.log(algumObjeto);

O output vai se parecer como algo assim:

[09:27:13.475] ({str:"Algum texto", id:5})

Output de mltiplos objetos

Voc tambm pode realizar o output de mltiplos objetos ao simplesmente list-los ao chamar o mtodo de log, desta forma:

var carro = "Fusca";
var algumObjeto = { str: "Algum texto", id: 5 };
console.info(
  "Meu primeiro carro era um ",
  carro,
  ". O objeto : ",
  algumObjeto,
);

O output ser algo assim:

[09:28:22.711] Meu primeiro carro era um Fusca. O objeto :  ({str:"Algum texto", id:5})

Uso de substituio de string

O Gecko 9.0 introduziu o suporte substituio de strings. Ao fornecer uma string para um dos mtodos do console que aceitam uma string, voc pode utilizar estas strings de substituio:

Cada um destes puxam o prximo argumento na lista de parmetros aps a string fornecida inicialmente. Por exemplo:

for (var i=0; i<5; i++) {
  console.log("Ol, %s. Voc me chamou pela %d vez.", "Joo", i+1);
}

O output ser algo assim:

[13:14:13.481] Ol, Joo. Voc me chamou pela 1 vez.
[13:14:13.483] Ol, Joo. Voc me chamou pela 2 vez.
[13:14:13.485] Ol, Joo. Voc me chamou pela 3 vez.
[13:14:13.487] Ol, Joo. Voc me chamou pela 4 vez.
[13:14:13.488] Ol, Joo. Voc me chamou pela 5 vez.

Estilizando o output no console

You can use the "%c" directive to apply a CSS style to console output:

console.log("%cMy stylish message", "color: red; font-style: italic");

[]

Usando grupos no console

You can use nested groups to help organize your output by visually combining related material. To create a new nested block, call console.group(). The console.groupCollapsed() method is similar, but creates the new block collapsed, requiring the use of a disclosure button to open it for reading.

console.log("This is the outer level");
console.group();
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");

The output looks like this:

[nesting.png]

Temporizadores

In order to calculate the duration of a specific operation, Gecko 10 introduced the support of timers in the console object. To start a timer, call the console.time() method, giving it a name as only parameter. To stop the timer, and to get the elapsed time in miliseconds, just call the console.timeEnd() method, again passing the timer's name as the parameter. Up to 10,000 timers can run simultaneously on a given page.

For example, given this code:

console.time("answer time");
alert("Click to continue");
console.timeEnd("answer time");

will log the time needed by the user to discard the alert box:

[timerresult.png]

Notice that the timer's name is displayed both when the timer is started and when it's stopped.

Stack traces

The console object also supports outputting a stack trace; this will show you the call path taken to reach the point at which you call console.trace(). Given code like this:

foo();

function foo() {
  function bar() {
    console.trace();
  }
  bar();
}

The output in the console looks something like this:

[]

Notes

• At least in Firefox, if a page defines a console object, that object overrides the one built into Firefox.
• Prior to Gecko 12.0, the console object's methods only work when the Web Console is open. Starting with Gecko 12.0, output is cached until the Web Console is opened, then displayed at that time.
• It's worth noting that the Firefox's built-in console object is compatible with the one provided by Firebug.

See also

• Tools
• Web Console - how the Web Console in Firefox handles console API calls
• Remote debugging - how to see console output when the debugging target is a mobile device
• Debugging apps on Firefox OS - using the App Manager to debug apps running on Firefox OS
• On-device console logging - how to do logging on Firefox OS devices

Other implementations

• Google Chrome DevTools;
• Firebug;
• Internet Explorer;
• Safari.