From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/pt-br/web/api/console/assert/index.html | 148 ++++++++++++++ files/pt-br/web/api/console/clear/index.html | 38 ++++ files/pt-br/web/api/console/count/index.html | 168 ++++++++++++++++ files/pt-br/web/api/console/dir/index.html | 108 ++++++++++ files/pt-br/web/api/console/error/index.html | 160 +++++++++++++++ files/pt-br/web/api/console/index.html | 242 +++++++++++++++++++++++ files/pt-br/web/api/console/info/index.html | 154 +++++++++++++++ files/pt-br/web/api/console/log/index.html | 119 +++++++++++ files/pt-br/web/api/console/table/index.html | 143 ++++++++++++++ files/pt-br/web/api/console/time/index.html | 103 ++++++++++ files/pt-br/web/api/console/timeend/index.html | 90 +++++++++ files/pt-br/web/api/console/timestamp/index.html | 106 ++++++++++ files/pt-br/web/api/console/warn/index.html | 139 +++++++++++++ 13 files changed, 1718 insertions(+) create mode 100644 files/pt-br/web/api/console/assert/index.html create mode 100644 files/pt-br/web/api/console/clear/index.html create mode 100644 files/pt-br/web/api/console/count/index.html create mode 100644 files/pt-br/web/api/console/dir/index.html create mode 100644 files/pt-br/web/api/console/error/index.html create mode 100644 files/pt-br/web/api/console/index.html create mode 100644 files/pt-br/web/api/console/info/index.html create mode 100644 files/pt-br/web/api/console/log/index.html create mode 100644 files/pt-br/web/api/console/table/index.html create mode 100644 files/pt-br/web/api/console/time/index.html create mode 100644 files/pt-br/web/api/console/timeend/index.html create mode 100644 files/pt-br/web/api/console/timestamp/index.html create mode 100644 files/pt-br/web/api/console/warn/index.html (limited to 'files/pt-br/web/api/console') diff --git a/files/pt-br/web/api/console/assert/index.html b/files/pt-br/web/api/console/assert/index.html new file mode 100644 index 0000000000..571815d791 --- /dev/null +++ b/files/pt-br/web/api/console/assert/index.html @@ -0,0 +1,148 @@ +--- +title: Console.assert() +slug: Web/API/Console/assert +translation_of: Web/API/console/assert +--- +
{{APIRef("Console API")}}
+ +

Escreve uma mensagem de erro para o console se a afirmação é falsa. Se a firmação é verdadeira, nada acontece.

+ +

{{AvailableInWorkers}}

+ +
+

Note: O método console.assert() é implementado de forma diferente em Node.js.
+ Especificamente, em navegadores, chamando o método console.assert() com uma afirmação falsa fará com que a mensagem a ser impressa para o console não interrompa a execução do código subsequente. Em Node.js, no entanto, uma afirmação falsa causará um AssertionError.

+
+ +

Sintaxe

+ +
console.assert(afirmação, obj1 [, obj2, ..., objN]);
+console.assert(afirmação, msg [, subst1, ..., substN]); // c-mensagem de formatação
+
+ +

Parâmetros

+ +
+
afirmação
+
Qualquer expressão booleana. Se a afirmação é falsa, a mensagem é impressa no console.
+
obj1 ... objN
+
Uma lista de objetos JavaScript para escrever. As representações de strings de cada um desses objetos são acrescentados juntos na ordem dada e saída.
+
msg
+
Uma String que contém zero ou mais seguências de substituição.
+
subst1 ... substN
+
Objetos JavaScript com qual as strings de substituição msg serão substituidas. Isto dá um contriole adicional sobre a mensagem que será escrita.
+
+ +

Ver Outputting text to the console na documentação do {{domxref("console")}} para mais detalhes.

+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçõesStatusComentário
{{SpecName("Console API", "#consoleassertexpression-object", "console.assert()")}}{{Spec2("Console API")}}Initial definition
+ +

Compatibilidade entre os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte Básico{{CompatVersionUnknown}}{{CompatGeckoDesktop("28.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+

Disponível para trabalhadores

+ 		{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
c-like message formatting{{CompatNo}}{{CompatGeckoDesktop("28.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatUnknown}}{{CompatGeckoMobile("28.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Disponível para trabalhadores{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
c-like message formatting{{CompatUnknown}}{{CompatGeckoMobile("28.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Ver também

+ + diff --git a/files/pt-br/web/api/console/clear/index.html b/files/pt-br/web/api/console/clear/index.html new file mode 100644 index 0000000000..f7ae8df40f --- /dev/null +++ b/files/pt-br/web/api/console/clear/index.html @@ -0,0 +1,38 @@ +--- +title: console.clear() +slug: Web/API/Console/clear +translation_of: Web/API/Console/clear +--- +
{{APIRef("Console API")}}
+ +

O método console.clear() limpa o console, se o ambiente permitir.

+ +

Sintaxe

+ +
console.clear();
+
+ +

Especificações

+ + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Console API", "#clear", "console.clear()")}}{{Spec2("Console API")}}Initial definition
+ +

Compatibilidade de Browser

+ + + +

{{Compat("api.Console.clear")}}

diff --git a/files/pt-br/web/api/console/count/index.html b/files/pt-br/web/api/console/count/index.html new file mode 100644 index 0000000000..b9328b5e91 --- /dev/null +++ b/files/pt-br/web/api/console/count/index.html @@ -0,0 +1,168 @@ +--- +title: Console.count() +slug: Web/API/Console/count +translation_of: Web/API/Console/count +--- +
{{APIRef("Console API")}}
+ +

Exibe o número de vezes em que a chamada count() em particular foi invocada. Essa função recebe um argumento opcional label.

+ +

{{AvailableInWorkers}}

+ +

Se label é fornecido, essa função exibe o número de vezes que a função count() foi chamada com a respectiva label.

+ +

Se label for omitido, a função exibe o número de vezes que a função count() foi chamada na respectiva linha.

+ +

Por exemplo, no código abaixo:

+ +
var usuario = "";
+
+function cumprimentar() {
+  console.count();
+  return "olá " + usuario;
+}
+
+usario = "bob";
+cumprimentar();
+usario = "alice";
+cumprimentar();
+cumprimentar();
+console.count();
+ +

A saída do console será algo como:

+ +
"<no label>: 1"
+"<no label>: 2"
+"<no label>: 3"
+"<no label>: 1"
+
+ +

Note a última linha da saída do console: a chamada individual de count() na linha 11 é tratada como um evento independente.

+ +

Se passarmos a variável usuario como o argumento label para a primeira invocação de count(), e a string "alice" para a segunda:

+ +
var usuario = "";
+
+function cumprimentar() {
+  console.count(usuario);
+  return "olá " + usuario;
+}
+
+usuario = "bob";
+cumprimentar();
+usuario = "alice";
+cumprimentar();
+cumprimentar();
+console.count("alice");
+ +

Teremos uma saída assim:

+ +
"bob: 1"
+"alice: 1"
+"alice: 2"
+"alice: 3"
+ +

Agora estamos mantendo contagens separadamente baseadas no valor de label. Como a label "alice" na linha 11 corresponde ao valor de usuario duas vezes, não é considerado um evento independente.

+ +

Sintaxe

+ +
console.count([label]);
+
+ +

Parâmetros

+ +
+
label
+
Uma string. Se for fornecida, exibe o número de vezes que  count() foi invocada com a mesma label.
+
+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName("Console API", "#count", "console.count()")}}{{Spec2("Console API")}}Definição inicial
+ +

Compatibilidade de browsers

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("30.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Disponível em workers{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RecursoAndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("30.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Disponível em Workers{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
diff --git a/files/pt-br/web/api/console/dir/index.html b/files/pt-br/web/api/console/dir/index.html new file mode 100644 index 0000000000..aa5c153903 --- /dev/null +++ b/files/pt-br/web/api/console/dir/index.html @@ -0,0 +1,108 @@ +--- +title: Console.dir() +slug: Web/API/Console/dir +tags: + - API + - console +translation_of: Web/API/Console/dir +--- +

{{ APIRef("Console API") }}{{Non-standard_header}}

+ +

Resumo

+ +

Exibe uma lista interativa das propriedades do objeto JavaScript especificado. A saída é apresentada como uma lista hierárquica com triângulos que permitem ver o conteúdo de objetos-filho.

+ +

{{AvailableInWorkers}}

+ +

console-dir.png

+ +

Sintaxe

+ +
console.dir(object);
+
+ +

Parâmetros

+ +
+
object
+
Um objeto JavaScript cujas propriedades devem ser emitidas.
+
+ +

Especificação

+ +

Console Object API

+ +

Compatibilidade do Browser

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{ CompatVersionUnknown() }}{{ CompatGeckoDesktop("8.0") }}9{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Disponível em trabalhos{{ CompatUnknown() }}{{ CompatGeckoDesktop("38.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{ CompatUnknown() }}{{ CompatGeckoMobile("8.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Disponível em trabalhos{{ CompatUnknown() }}{{ CompatGeckoDesktop("38.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +

 

+ +

Ver também

+ + diff --git a/files/pt-br/web/api/console/error/index.html b/files/pt-br/web/api/console/error/index.html new file mode 100644 index 0000000000..bf0ff45540 --- /dev/null +++ b/files/pt-br/web/api/console/error/index.html @@ -0,0 +1,160 @@ +--- +title: Console.error() +slug: Web/API/Console/error +translation_of: Web/API/Console/error +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

'Escreve' uma mensagem de erro no  Web Console.

+ +

{{AvailableInWorkers}}

+ +

Sintaxe

+ +
console.error(obj1 [, obj2, ..., objN]);
+console.error(msg [, subst1, ..., substN]);
+console.exception(obj1 [, obj2, ..., objN]);
+console.exception(msg [, subst1, ..., substN]);
+
+ +
+

Nota: console.exception() é um alias para console.error(); as funcionalidades deles são identicas.

+
+ +

Parâmetros

+ +
+
obj1 ... objN
+
Uma lista de objetos Javascript para serem escritos. As representações String de cada um destes objetos é ligada junto na ordem listada e escrita.
+
msg
+
Uma String Javascript contendo zero ou mais Strings de substituição.
+
subst1 ... substN
+
Objetos JavaScript o qual substituirão as Strings no msg. Este parâmetro fornece controle adicional sobre o formato de output.
+
+ +

Veja Outputting text to the console na documentação de {{domxref("console")}} para mais detalhes.

+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName("Console API", "#consoleerrorobject--object-", "console.error()")}}{{Spec2("Console API")}}Initial definition
+ +

Compatibilidade com os navegadores

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Substituição de Strings{{CompatVersionUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
console.exception alias{{CompatNo}}{{CompatGeckoDesktop("28.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Disponível em workers{{CompatUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Substituição de Strings{{CompatUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
console.exception alias{{CompatNo}}{{CompatGeckoMobile("28.0")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Disponível em workers{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Ver também

+ + diff --git a/files/pt-br/web/api/console/index.html b/files/pt-br/web/api/console/index.html new file mode 100644 index 0000000000..c8d6331685 --- /dev/null +++ b/files/pt-br/web/api/console/index.html @@ -0,0 +1,242 @@ +--- +title: Console +slug: Web/API/Console +translation_of: Web/API/Console +--- +
+
{{APIRef("Console API")}}{{Non-standard_header}}
+
+ +

O objeto console fornece acesso ao console de debug do navegador (por exemplo, o Web Console do Firefox). O seu funcionamento específico varia de navegador para navegador, mas existe um conjunto de ferramentas que na prática são fornecidas normalmente.

+ +

Esta página documenta os {{anch("Métodos")}} disponíveis no objeto console e fornece alguns exemplos de {{anch("Uso")}}.

+ +

Métodos

+ +
+
{{domxref("console.assert()", "console.assert(expression, object[, object...])")}}
+
Emite uma mensagem e traça a sequência de operações até o primeiro argumento for falso.
+
{{domxref("console.count()", "console.count([label])")}}
+
Mostra o número de vezes que esta linha foi chamada com a label fornecida.
+
{{domxref("console.log()", "console.debug(object[, object...])")}} {{deprecated_inline("5.0")}}
+
Um atalho para log(); que foi adicionado para melhorar a compatibilidade de páginas já existentes que utilizavam debug(). Porém, ao invés destes comandos você deve utilizar {{domxref("console.log()")}}.
+
{{domxref("console.dir()", "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 conteúdo de objetos filhos.
+
{{domxref("console.error()", "console.error(object[, object...])")}}
+
Emite uma mensagem de erro. Você pode usar substituição de string e outros argumentos adicionais com este método. Consulte {{anch("Uso de substituição de string")}}.
+
{{domxref("console.error()", "console.exception(object[, object...])")}}
+
Um atalho para error();
+
{{domxref("console.group()", "console.group(object[, object...])")}}
+
Cria um novo grupo em linha e recua todas as mensagens seguintes para um nível de indentação superior. Para voltar um nível, utilize groupEnd(). Consulte {{anch("Uso de grupos no console")}}.
+
{{domxref("console.groupCollapsed()", "console.groupCollapsed(object[, object...])")}}
+
Cria um novo grupo em linha e recua todas as mensagens seguintes para um nível de indentação superior; ao contrário de group(), o grupo em linha começa recolhido. Para revelar seu conteúdo, basta clicar no botão de revelação para expandí-lo. Para recuar um nível, utilize groupEnd(). Consulte {{anch("Uso de grupos no console")}}.
+
{{domxref("console.groupEnd()")}}
+
Sai do grupo em linha atual. Veja {{anch("Uso de grupos no console")}}.
+
{{domxref("console.info()", "console.info(object[, object...])")}}
+
Informações de registro. Você pode utilizar substituição de string e outros argumentos com este método. Consulte {{anch("Uso de substituição de string")}}.
+
{{domxref("console.log()", "console.log(object[, object...])")}}
+
Utilizado para a emissão de informações de registro em geral. Você pode utilizar substituição de string e outros argumentos com este método. Consulte {{anch("Uso de substituição de string")}}.
+
{{domxref("console.profile()", "console.profile( [profileLabel] )")}}
+
Inicia o JavaScript profiler. Você pode especificar qualquer label opcional para o perfil.
+
{{domxref("console.profileEnd()")}}
+
Interrompe o profiler. Você pode ver o profile resultante no JavaScript profiler.
+
+ +

 

+ +
+
{{domxref("Console.table()")}}
+
Exibe dados, como objeto e array, como uma tabela.
+
+ +

 

+ +
+
{{domxref("console.time()", "console.time(name)")}}
+
Inicia um contador de tempo com o nome especificado no parâmetro name. Até 10.000 contadores de tempo podem ser rodados por página.
+
{{domxref("console.timeEnd()", "console.timeEnd(name)")}}
+
Interrompe o contador de tempo especificado e emite o tempo e registros do contador de tempo em milisegundos desde o seu início. Veja {{anch("Contadores de Tempo")}}.
+
{{domxref("console.trace()")}}
+
Emite um traçado de pilha. See {{anch("Traçados de pilha")}}.
+
{{domxref("console.warn()", "console.warn(object[, object...])")}}
+
Emite uma mensagem de alerta. Você pode utilizar substituição de string e argumentos adicionais com este método. Veja {{anch("Uso de substituição de string")}}.
+
+ + +

Uso

+ +

Output de texto para o console

+ +

A utilização mais frequente do console é realizar o log de texto e de outros dados. Há quatro categorias de output que podem ser geradas, utilizando os métodos {{domxref("console.log()")}}, {{domxref("console.info()")}}, {{domxref("console.warn()")}} e o {{domxref("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 métodos de outuput. Você pode simplemente passar uma lista dos objetos cuja representação em string será concatenadas em uma string e então realizar o output  para o console, ou você pode passar uma string contendo zero ou mais substituições de strings seguidas por uma lista de objetos para serem utilizados na substituição.

+ +

Output de um único objeto

+ +

A forma mais simples de utilizar os métodos 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 múltiplos objetos

+ +

Você também pode realizar o output de múltiplos objetos ao simplesmente listá-los ao chamar o método 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 substituição de string

+ +

O Gecko 9.0 {{geckoRelease("9.0")}} introduziu o suporte à substituição de strings. Ao fornecer uma string para um dos métodos do console que aceitam uma string, você pode utilizar estas strings de substituição:

+ + + + + + + + + + + + + + + + + + + + + + + + +
String de substituiçãoDescrição
%oEmite um link para o objeto JavaScript. Clicar no link abre um inspetor.
%d ou %iEmite uma numero inteiro. A formatação ainda não possui suporte.
%sEmite uma string.
%fEmite um número de ponto flutuante. A formatação ainda não possui suporte.
+ +

Cada um destes puxam o próximo argumento na lista de parâmetros após a string fornecida inicialmente. Por exemplo:

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

O output será algo assim:

+ +
[13:14:13.481] Olá, João. Você me chamou pela 1ª vez.
+[13:14:13.483] Olá, João. Você me chamou pela 2ª vez.
+[13:14:13.485] Olá, João. Você me chamou pela 3ª vez.
+[13:14:13.487] Olá, João. Você me chamou pela 4ª vez.
+[13:14:13.488] Olá, João. 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");
+ +
+ +
{{h3_gecko_minversion("Using groups in the console", "9.0")}}
+ +

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.

+ +
Note: Collapsed groups are not supported yet in Gecko; the groupCollapsed() method is the same as group() at this time.
+ +

To exit the current group, simply call console.groupEnd().

+ +

For example, given this code:

+ +
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

+ +
{{h3_gecko_minversion("Timers", "10.0")}}
+ +

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.

+ +
Note: It's important to note that if you're using this to log the timing for network traffic, the timer will report the total time for the transaction, while the time listed in the network panel is just the amount of time required for the header. If you have response body logging enabled, the time listed for the response header and body combined should match what you see in the console output.
+ +

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 {{domxref("console.trace()")}}. Given code like this:

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

The output in the console looks something like this:

+ +

+ +

Notes

+ + + +

See also

+ + + +

Other implementations

+ +

 

+ + diff --git a/files/pt-br/web/api/console/info/index.html b/files/pt-br/web/api/console/info/index.html new file mode 100644 index 0000000000..e4033e254d --- /dev/null +++ b/files/pt-br/web/api/console/info/index.html @@ -0,0 +1,154 @@ +--- +title: Console.info() +slug: Web/API/Console/info +translation_of: Web/API/Console/info +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

Apresenta uma mensagem de saída no console do navegador . No Firefox e Chrome , um pequeno ícone "i" e apresentado próximo aos items do log do console .  

+ +

{{AvailableInWorkers}}

+ +

Sintaxe

+ +
console.info(obj1 [, obj2, ..., objN]);
+console.info(msg [, subst1, ..., substN]);
+
+ +

Parâmetros

+ +
+
obj1 ... objN
+
A lista de objetos javascript para saída . As representações de strings de cada um desses objetos são anexados juntos em ordem de listagem e saida . 
+
msg
+
Uma string javascript que contém zero ou mais strings para substituição.
+
subst1 ... substN
+
Objeto javascript o qual substitui strings com msg. Isso permite controle adicional sobre o formato da saída.
+
+ +

Veja Outputting text to the console na documentação {{domxref("console")}} para mais  detalhes.

+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçõesStatusComentários
{{SpecName("Console API", "#consoleinfoobject--object-", "console.info()")}}{{Spec2("Console API")}}Definição inicial
+ +

Compatibilidade de Browser

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticasChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Substituição de strings{{CompatUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Icones informação{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatNo}}
Disponível para trabalhadores{{CompatUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticasAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Substituição de  strings{{CompatUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+ + + + + + + +
Disponível para trabalhadores 
+ 		{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Veja  também

+ + diff --git a/files/pt-br/web/api/console/log/index.html b/files/pt-br/web/api/console/log/index.html new file mode 100644 index 0000000000..b25a14a3fe --- /dev/null +++ b/files/pt-br/web/api/console/log/index.html @@ -0,0 +1,119 @@ +--- +title: Console.log() +slug: Web/API/Console/log +translation_of: Web/API/Console/log +--- +
{{APIRef("Console API")}}{{Non-standard_header}}
+ +

Sumário

+ +

Exibe uma mensagem na console do navegador.

+ +

Syntax

+ +
console.log(obj1[, obj2, ..., objN]);
+console.log(msg[, subst1, ..., substN]);
+
+ +

Parameters

+ +
+
obj1 ... objN
+
Uma lista de objetos JavaScript para exibir. A representação por escrito de cada um desses objetos é exibida na ordem com a qual foram inseridos na função.
+
msg
+
Uma string JavaScript com zero ou mais substituições.
+
subst1 ... substN
+
Strings ou objetos JavaScript para substituirem as marcações de substituição em msg. Estas substituições ocorrem de um para um e na ordem em que são passadas para a console.log.
+
+ +

Veja Exibindo texto na console na documentação do objeto {{domxref("console")}} para mais detalhes.

+ +

Especificação

+ +

Não faz parte de nenhuma especificação.

+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Strings de substituição +

{{CompatVersionUnknown}}

+ +

{{CompatChrome(28)}}

+ +

%d - se um valor fracional negativo é passado, ele será arredondado para baixo, exemplo: -0,35 será arredondado para 1

+ 		{{CompatGeckoDesktop("9.0")}} +

10 - parcial

+ +

%c - não suportado
+ %d - irá renderizar como 0 quando NaN

+ 		{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Strings de substituição{{CompatUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Ver também

+ + diff --git a/files/pt-br/web/api/console/table/index.html b/files/pt-br/web/api/console/table/index.html new file mode 100644 index 0000000000..946a642003 --- /dev/null +++ b/files/pt-br/web/api/console/table/index.html @@ -0,0 +1,143 @@ +--- +title: Console.table() +slug: Web/API/Console/table +translation_of: Web/API/Console/table +--- +
{{APIRef("Console API")}}
+ +

Exibe dados tabulares como uma tabela.

+ +

Essa função recebe um parâmetro obrigatório data, que deve ser um array ou um objeto, e um parametro opcional columns.

+ +

Registra data como uma tabela. Cada elemento no array (ou propriedade enumerável se data for um objeto) será uma linha na tabela.

+ +

A primeira coluna na tabela será rotulada (index). Se data for um array, seus valores serão os índices da matriz. Se data for um objeto, seus valores serão os nomes das propriedades. Observe que (no Firefox) o console.table está limitado a exibir 1000 linhas (a primeira linha é o índice rotulado).

+ +

{{AvailableInWorkers}}

+ +

Coleções de tipos primitivos

+ +

O argumento data pode ser um array ou um objeto.

+ +
// um array de strings
+
+console.table(["apples", "oranges", "bananas"]);
+ +

+ +
// um objeto cujas propriedades são strings
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var me = new Person("John", "Smith");
+
+console.table(me);
+ +

+ +

Coleções de tipos compostos

+ +

Se os elementos no array, ou propriedades no objeto, forem arrays ou objetos, seus elementos ou propriedades serão enumerados na linha, um por coluna:

+ +
// um array de arrays
+
+var people = [["John", "Smith"], ["Jane", "Doe"], ["Emily", "Jones"]]
+console.table(people);
+ +

Table displaying array of arrays

+ +
// um array de objetos
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var john = new Person("John", "Smith");
+var jane = new Person("Jane", "Doe");
+var emily = new Person("Emily", "Jones");
+
+console.table([john, jane, emily]);
+ +

Observe que, se a matriz contiver objetos, as colunas serão rotuladas com o nome da propriedade.

+ +

Table displaying array of objects

+ +
// um objeto cujas propriedades são objetos
+
+var family = {};
+
+family.mother = new Person("Jane", "Smith");
+family.father = new Person("John", "Smith");
+family.daughter = new Person("Emily", "Smith");
+
+console.table(family);
+ +

Table displaying object of objects

+ +

Restringindo as colunas exibidas

+ +

Por padrão, console.table() lista todos os elementos em cada linha. Você pode usar o parâmetro opcional columns para selecionar um subconjunto de colunas a serem exibidas:

+ +
// um array de objetos, registrando apenas firstName
+
+function Person(firstName, lastName) {
+  this.firstName = firstName;
+  this.lastName = lastName;
+}
+
+var john = new Person("John", "Smith");
+var jane = new Person("Jane", "Doe");
+var emily = new Person("Emily", "Jones");
+
+console.table([john, jane, emily], ["firstName"]);
+ +

Table displaying array of objects with filtered output

+ +

Classificando colunas

+ +

Você pode classificar a tabela por uma coluna específica clicando no rótulo dessa coluna.

+ +

Sintaxe

+ +
console.table(data [, columns]);
+
+ +

Parâmentros

+ +
+
data
+
Os dados a serem exibidos. Deve ser um array ou um objeto.
+
columns
+
Um array contendo os nomes das colunas para incluir na saída.
+
+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName("Console API", "#table", "console.table()")}}{{Spec2("Console API")}}Definição inicial
+ +

Compatibilidade de browsers

+ +
+ + +

{{Compat("api.Console.table")}}

+
diff --git a/files/pt-br/web/api/console/time/index.html b/files/pt-br/web/api/console/time/index.html new file mode 100644 index 0000000000..14b6f4a03c --- /dev/null +++ b/files/pt-br/web/api/console/time/index.html @@ -0,0 +1,103 @@ +--- +title: Console.time() +slug: Web/API/Console/time +translation_of: Web/API/Console/time +--- +

{{ APIRef("Console API") }}{{Non-standard_header}}

+ +

Sumário

+ +

Inicia um cronômetro que você pode usar para monitorar quanto tempo uma operação leva. Você dá para cada cronômetro um nome único, e deve ter no máximo 10.000 deles sendo executados na página. Quando você chama {{ domxref("console.timeEnd()") }} com o mesmo nome, o navegador mostrará o tempo, em milisegundos, que se passou desde que o cronômetro iniciou.

+ +

Veja Timers na documentação {{ domxref("console") }} para detalhes e exemplos.

+ +

{{AvailableInWorkers}}

+ +

Sintaxe

+ +
console.time(cronometroNome);
+
+ +

Parâmetros

+ +
+
cronometroNome
+
O nome para dar ao novo cronômetro. Ele identificará o cronômetro; use o mesmo quando chamar {{ domxref("console.timeEnd()") }} para parar o cronômetro e obter o tempo na saída do console.
+
+ +

Especificação

+ +

API do objeto Console

+ +

Compatibilidade com navegadores

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico2{{ CompatGeckoDesktop("10.0") }}11{{ CompatVersionUnknown() }}4.0
Disponível em Workers{{ CompatUnknown() }}{{ CompatGeckoDesktop("38.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{ CompatUnknown() }}{{ CompatGeckoMobile("10.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Disponível em Workers{{ CompatUnknown() }}{{ CompatGeckoMobile("38.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/console/timeend/index.html b/files/pt-br/web/api/console/timeend/index.html new file mode 100644 index 0000000000..7ef63ea5bc --- /dev/null +++ b/files/pt-br/web/api/console/timeend/index.html @@ -0,0 +1,90 @@ +--- +title: Console.timeEnd() +slug: Web/API/Console/timeEnd +tags: + - Desenvolvimento Web + - metodo +translation_of: Web/API/Console/timeEnd +--- +
+
{{APIRef("Console API")}}{{Non-standard_header}}
+
+ +

Resumo

+ +

Interrompe um temporizador que foi anteriormente iniciado por uma chamada a {{domxref("console.time()")}}.

+ +

Veja Timers na documentação de {{domxref("console")}} para detalhes e exemplos.

+ +

Sintaxe

+ +
console.timeEnd(timerName);
+
+ +

Parametros

+ +
+
timerName
+
O nome do temporizador a ser interrompido. Uma vez interrompido, o tempo decorrido é automaticamente apresentado no Web Console.
+
+ +

Especificação

+ +

Não é parte de qualquer especificação.

+ +

Compatibilidade com navegadores

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support2{{CompatGeckoDesktop("10.0")}}11{{CompatVersionUnknown}}4.0
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatGeckoMobile("10.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/console/timestamp/index.html b/files/pt-br/web/api/console/timestamp/index.html new file mode 100644 index 0000000000..774ee4048b --- /dev/null +++ b/files/pt-br/web/api/console/timestamp/index.html @@ -0,0 +1,106 @@ +--- +title: Console.timeStamp() +slug: Web/API/Console/timeStamp +translation_of: Web/API/Console/timeStamp +--- +

{{ APIRef("Console API") }}{{Non-standard_header}}

+ +

Sumário

+ +

Adiciona um marcador simples para as ferramentas Timeline ou Waterfall do navegador. Ele deixa você relacionar um ponto no seu código com os outros eventos gravados na linha do tempo, como um evento de layout ou de pintura.

+ +

Opcionalmente, você pode fornecer um argumento como rótulo do carimbo de hora, e esse rótulo será então mostrado juntamente com a marcação.

+ +
+

Nota: essa funcionalidade está disponível em Web Workers.

+
+ +

Sintaxe

+ +
console.timeStamp(rotulo);
+
+ +

Parâmetros

+ +
+
rotulo
+
Rótulo para o carimbo de hora. Opcional.
+
+ +

Especificação

+ +

API do objeto Console

+ +

Compatibilidade com navegadores

+ +

{{ CompatibilityTable() }}

+ +
{{ CompatUnknown() }} + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatNo() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Disponível em workers{{ CompatVersionUnknown() }}{{ CompatGeckoDesktop("38.0") }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{ CompatUnknown() }}{{ CompatGeckoMobile("10.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
Disponível em workers{{ CompatUnknown() }}{{ CompatGeckoMobile("38.0") }}{{ CompatUnknown() }}{{ CompatUnknown() }}{{ CompatUnknown() }}
+
+ +

Veja também

+ + diff --git a/files/pt-br/web/api/console/warn/index.html b/files/pt-br/web/api/console/warn/index.html new file mode 100644 index 0000000000..73eab6abee --- /dev/null +++ b/files/pt-br/web/api/console/warn/index.html @@ -0,0 +1,139 @@ +--- +title: Console.warn() +slug: Web/API/Console/warn +translation_of: Web/API/Console/warn +--- +
{{APIRef("Console API")}}{{non-standard_header}}
+ +

Escreve uma mensagem de alerta no Console Web.

+ +

{{AvailableInWorkers}}

+ +

{{Note("No Firefox, warnings têm um pequeno icone de ponto de exclamação perto deles no log do Console Web.")}}

+ +

Sintaxe

+ +
console.warn(obj1 [, obj2, ..., objN]);
+console.warn(msg [, subst1, ..., substN]);
+
+ +

Parâmetros

+ +
+
obj1 ... objN
+
Uma lista de objetos JavaScript para escrever. A representação String de cada um destes objetos é ligada junto na ordem listada e escrita.
+
msg
+
Uma string JavaScript contendo zero ou mais strings de substituição.
+
subst1 ... substN
+
Objetos JavaScript com qual as strings de substituição msg serão substituidas. Isto dá um contriole adicional sobre a mensagem que será escrita.
+
+ +

Ver Outputting text to the console na documentação do {{domxref("console")}} para mais detalhes.

+ +

Especificações

+ + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName("Console API", "#consolewarnobject--object-", "console.warn()")}}{{Spec2("Console API")}}Definição inicial
+ +

Compatibilidade entre os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Suporte básico{{CompatVersionUnknown}}{{CompatGeckoDesktop("2.0")}}8{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Substituição strings{{CompatUnknown}}{{CompatGeckoDesktop("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Disponível em workers{{CompatUnknown}}{{CompatGeckoDesktop("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Suporte básico{{CompatUnknown}}{{CompatGeckoMobile("2.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Substituição strings{{CompatUnknown}}{{CompatGeckoMobile("9.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
Disponível em workers{{CompatUnknown}}{{CompatGeckoMobile("38.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

Ver também

+ + -- cgit v1.2.3-54-g00ecf