From 166bdbc53c248f92c85ebd18ff3b52f1d98fff46 Mon Sep 17 00:00:00 2001 From: Vitor Bertazzo Date: Sun, 30 Jun 2019 14:14:18 -0300 Subject: [PATCH 1/3] pt-BR: Translate 'how-to-use-util-inspect' --- .../how-to-use-util-inspect.md | 88 +++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md diff --git a/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md b/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md new file mode 100644 index 0000000000000..d1167a749e511 --- /dev/null +++ b/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md @@ -0,0 +1,88 @@ +--- +title: Como usar util.inspect +date: '2011-08-26T10:08:50.000Z' +tags: + - core + - debug +difficulty: 1 +layout: knowledge-post.hbs +--- + + + +O Node oferece uma função utilitária, para fins de depuração, que retorna uma representação string de um objeto. `util.inspect ()` pode ser de grande ajuda quando utilizada com propriedades de grandes e complexos objetos. + +Vamos ver um exemplo simples. `util.inspect()` pode ser usado em qualquer objeto - uma boa demonstração será utilizá-la em um dos objetos internos do Node. Tente isso no REPL (digite `node` na sua linha de comando, sem argumentos): + + var util = require('util'); + util.inspect(console); + + + +O output vai ser: + + '{ log: [Function], info: [Function], warn: [Function], error: [Function], dir: [Function], time: [Function], timeEnd: [Function], trace: [Function], assert: [Function] }' + +Esta é uma listagem de todas as propriedades enumeráveis ​​do objeto `console`. Também vale a pena notar que `console.dir` é um wrapper em torno de ` util.inspect` que utiliza seus argumentos padrão. + + + +No REPL, `util.inspect` retornará imediatamente seu output - esse não é o caso normalmente. No contexto de um código Node.js comum em um arquivo, algo deve ser feito com o output. A coisa mais simples a fazer: + + console.log(util.inspect(myObj)); + +`util.inspect` pode também receber diversos argumentos opcionais, mostrados aqui com seus valores padrão: + + util.inspect(object, showHidden=false, depth=2, colorize=true); + + + +Por exemplo, `util.inspect(myObj, true, 7, true)` inspecionaria `myObj`, mostrando todas as propriedades ocultas e não ocultas até uma profundidade de `7` e coloriria o output. Vamos conferir os argumentos individualmente. + +O argumento `depth` é o número de níveis dentro de um objeto aninhado para ser recursivo - o padrão é 2. Configurá-lo para `null` fará com que ele recurse tudo, mostrando todos os níveis. Compare o tamanho dos outputs dessas duas instruções `util.inspect` no REPL: + + var http = require('http'); + util.inspect(http, true, 1); + util.inspect(http, true, 3); + + + +O argumento opcional `showHidden` é um booleano que determina se as propriedades 'não-enumeráveis' de um objeto serão ou não exibidas - o padrão é `false`, o que tende a resultar em um output muito mais legível. Isso não é algo que um iniciante precise se preocupar na maior parte do tempo, mas vale a pena demonstrar brevemente. Mais uma vez, tente o seguinte no REPL: + + var util = require('util'); + util.inspect(console, true); + + + +Finalmente, o argumento opcional `colorize` é um booleano que adiciona códigos de escape ANSI ao output da string. Quando utilizado em uma janela de terminal, o output deve aparecer colorido. + + var util = require('util'); + console.log(util.inspect({a:1, b:"b"}, false,2,true)); From 4eebce014b35cfd8c0fd8b2f1f94a6d87e636ac8 Mon Sep 17 00:00:00 2001 From: Vitor Bertazzo Date: Mon, 1 Jul 2019 12:53:04 -0300 Subject: [PATCH 2/3] pt-BR: Fix typos and suggestions --- .../knowledge/getting-started/how-to-use-util-inspect.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md b/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md index d1167a749e511..005cc7c1a7eb4 100644 --- a/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md +++ b/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md @@ -15,7 +15,7 @@ Let's provide a basic example. `util.inspect()` can be used on any object - a go var util = require('util'); util.inspect(console); --> -O Node oferece uma função utilitária, para fins de depuração, que retorna uma representação string de um objeto. `util.inspect ()` pode ser de grande ajuda quando utilizada com propriedades de grandes e complexos objetos. +O Node oferece uma função utilitária, para fins de depuração, que retorna uma representação string de um objeto. `util.inspect()` pode ser de grande ajuda quando utilizada com propriedades de objetos que são muito grandes ou complexos. Vamos ver um exemplo simples. `util.inspect()` pode ser usado em qualquer objeto - uma boa demonstração será utilizá-la em um dos objetos internos do Node. Tente isso no REPL (digite `node` na sua linha de comando, sem argumentos): @@ -61,7 +61,7 @@ The `depth` argument is the number of levels deep into a nested object to recurs Por exemplo, `util.inspect(myObj, true, 7, true)` inspecionaria `myObj`, mostrando todas as propriedades ocultas e não ocultas até uma profundidade de `7` e coloriria o output. Vamos conferir os argumentos individualmente. -O argumento `depth` é o número de níveis dentro de um objeto aninhado para ser recursivo - o padrão é 2. Configurá-lo para `null` fará com que ele recurse tudo, mostrando todos os níveis. Compare o tamanho dos outputs dessas duas instruções `util.inspect` no REPL: +O argumento `depth` representa o número de níveis dentro de um objeto aninhado para ser recursivo - o padrão é 2. Configurá-lo para `null` fará com que ele vá até o último nível, mostrando todos os níveis. Compare o tamanho dos outputs dessas duas instruções `util.inspect` no REPL: var http = require('http'); util.inspect(http, true, 1); From 98cf61a4f883312ba8ebfc355b3ec00bf35a4fe2 Mon Sep 17 00:00:00 2001 From: Vitor Bertazzo Date: Wed, 3 Jul 2019 14:05:11 -0300 Subject: [PATCH 3/3] pt-BR: More fixes --- .../how-to-use-util-inspect.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md b/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md index 005cc7c1a7eb4..33c044de65296 100644 --- a/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md +++ b/locale/pt-br/knowledge/getting-started/how-to-use-util-inspect.md @@ -8,13 +8,13 @@ difficulty: 1 layout: knowledge-post.hbs --- - - + O Node oferece uma função utilitária, para fins de depuração, que retorna uma representação string de um objeto. `util.inspect()` pode ser de grande ajuda quando utilizada com propriedades de objetos que são muito grandes ou complexos. Vamos ver um exemplo simples. `util.inspect()` pode ser usado em qualquer objeto - uma boa demonstração será utilizá-la em um dos objetos internos do Node. Tente isso no REPL (digite `node` na sua linha de comando, sem argumentos): @@ -25,14 +25,14 @@ Vamos ver um exemplo simples. `util.inspect()` pode ser usado em qualquer objeto -O output vai ser: +O resultado vai ser: '{ log: [Function], info: [Function], warn: [Function], error: [Function], dir: [Function], time: [Function], timeEnd: [Function], trace: [Function], assert: [Function] }' -Esta é uma listagem de todas as propriedades enumeráveis ​​do objeto `console`. Também vale a pena notar que `console.dir` é um wrapper em torno de ` util.inspect` que utiliza seus argumentos padrão. +Esta é uma listagem de todas as propriedades enumeráveis ​​do objeto `console`. Também vale a pena notar que `console.dir` é um wrapper em torno de `util.inspect` que utiliza seus argumentos padrões. -No REPL, `util.inspect` retornará imediatamente seu output - esse não é o caso normalmente. No contexto de um código Node.js comum em um arquivo, algo deve ser feito com o output. A coisa mais simples a fazer: +No REPL, `util.inspect` retornará imediatamente seu resultado - esse não é o caso normalmente. No contexto de um código Node.js comum em um arquivo, algo deve ser feito com o resultado. A coisa mais simples a fazer: console.log(util.inspect(myObj)); -`util.inspect` pode também receber diversos argumentos opcionais, mostrados aqui com seus valores padrão: +`util.inspect` pode também receber diversos argumentos opcionais, mostrados aqui com seus valores padrões: util.inspect(object, showHidden=false, depth=2, colorize=true); @@ -59,9 +59,9 @@ The `depth` argument is the number of levels deep into a nested object to recurs util.inspect(http, true, 1); util.inspect(http, true, 3); --> -Por exemplo, `util.inspect(myObj, true, 7, true)` inspecionaria `myObj`, mostrando todas as propriedades ocultas e não ocultas até uma profundidade de `7` e coloriria o output. Vamos conferir os argumentos individualmente. +Por exemplo, `util.inspect(myObj, true, 7, true)` inspecionaria `myObj`, mostrando todas as propriedades ocultas e não ocultas até uma profundidade de `7` e coloriria o resultado. Vamos conferir os argumentos individualmente. -O argumento `depth` representa o número de níveis dentro de um objeto aninhado para ser recursivo - o padrão é 2. Configurá-lo para `null` fará com que ele vá até o último nível, mostrando todos os níveis. Compare o tamanho dos outputs dessas duas instruções `util.inspect` no REPL: +O argumento `depth` representa o número de níveis dentro de um objeto aninhado para ser recursivo - o padrão é 2. Configurá-lo para `null` fará com que ele vá até o último nível, mostrando todos os níveis. Compare o tamanho dos resultados dessas duas instruções `util.inspect` no REPL: var http = require('http'); util.inspect(http, true, 1); @@ -72,7 +72,7 @@ O argumento `depth` representa o número de níveis dentro de um objeto aninhado var util = require('util'); util.inspect(console, true); --> -O argumento opcional `showHidden` é um booleano que determina se as propriedades 'não-enumeráveis' de um objeto serão ou não exibidas - o padrão é `false`, o que tende a resultar em um output muito mais legível. Isso não é algo que um iniciante precise se preocupar na maior parte do tempo, mas vale a pena demonstrar brevemente. Mais uma vez, tente o seguinte no REPL: +O argumento opcional `showHidden` é um booleano que determina se as propriedades 'não-enumeráveis' de um objeto serão ou não exibidas - o padrão é `false`, o que tende a resultar em uma saída muito mais legível. Isso não é algo que um iniciante precise se preocupar na maior parte do tempo, mas vale a pena demonstrar brevemente. Mais uma vez, tente o seguinte no REPL: var util = require('util'); util.inspect(console, true); @@ -82,7 +82,7 @@ O argumento opcional `showHidden` é um booleano que determina se as propriedade var util = require('util'); console.log(util.inspect({a:1, b:"b"}, false,2,true)); --> -Finalmente, o argumento opcional `colorize` é um booleano que adiciona códigos de escape ANSI ao output da string. Quando utilizado em uma janela de terminal, o output deve aparecer colorido. +Finalmente, o argumento opcional `colorize` é um booleano que adiciona códigos de escape ANSI ao resultado da string. Quando utilizado em uma janela de terminal, o resultado deve aparecer colorido. var util = require('util'); console.log(util.inspect({a:1, b:"b"}, false,2,true));