From 85692053d369d6325dff76c2f6d0b82f60a36f52 Mon Sep 17 00:00:00 2001 From: Diogo Marciano Date: Mon, 9 Nov 2026 01:38:34 -0300 Subject: [PATCH 1/2] Translate "Eval: run a code string" article to Portuguese Co-Authored-By: Claude Sonnet 5 --- .../02-eval/1-eval-calculator/solution.md | 8 +-- .../02-eval/1-eval-calculator/task.md | 6 +- 1-js/99-js-misc/02-eval/article.md | 68 +++++++++---------- 3 files changed, 41 insertions(+), 41 deletions(-) diff --git a/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md b/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md index 24d40c9b8..b86786ae0 100644 --- a/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md +++ b/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md @@ -1,11 +1,11 @@ -Let's use `eval` to calculate the maths expression: +Vamos usar `eval` para calcular a expressão matemática: ```js demo run -let expr = prompt("Type an arithmetic expression?", '2*3+2'); +let expr = prompt("Digite uma expressão aritmética?", '2*3+2'); alert( eval(expr) ); ``` -The user can input any text or code though. +Porém, o usuário pode digitar qualquer texto ou código. -To make things safe, and limit it to arithmetics only, we can check the `expr` using a [regular expression](info:regular-expressions), so that it only may contain digits and operators. +Para deixar as coisas seguras, e limitar só a aritmética, podemos verificar `expr` usando uma [expressão regular](info:regular-expressions), de forma que ela só possa conter dígitos e operadores. diff --git a/1-js/99-js-misc/02-eval/1-eval-calculator/task.md b/1-js/99-js-misc/02-eval/1-eval-calculator/task.md index ece43ec9e..49be7a182 100644 --- a/1-js/99-js-misc/02-eval/1-eval-calculator/task.md +++ b/1-js/99-js-misc/02-eval/1-eval-calculator/task.md @@ -2,10 +2,10 @@ importance: 4 --- -# Eval-calculator +# Calculadora com eval -Create a calculator that prompts for an arithmetic expression and returns its result. +Crie uma calculadora que peça uma expressão aritmética e retorne seu resultado. -There's no need to check the expression for correctness in this task. Just evaluate and return the result. +Não há necessidade de verificar a expressão quanto à correção nesta tarefa. Apenas avalie e retorne o resultado. [demo] diff --git a/1-js/99-js-misc/02-eval/article.md b/1-js/99-js-misc/02-eval/article.md index 1fdafeeec..9b9f99b18 100644 --- a/1-js/99-js-misc/02-eval/article.md +++ b/1-js/99-js-misc/02-eval/article.md @@ -1,25 +1,25 @@ -# Eval: run a code string +# Eval: executa uma string de código -The built-in `eval` function allows to execute a string of code. +A função nativa `eval` permite executar uma string de código. -The syntax is: +A sintaxe é: ```js let result = eval(code); ``` -For example: +Por exemplo: ```js run let code = 'alert("Hello")'; eval(code); // Hello ``` -A string of code may be long, contain line breaks, function declarations, variables and so on. +Uma string de código pode ser longa, conter quebras de linha, declarações de função, variáveis e assim por diante. -The result of `eval` is the result of the last statement. +O resultado de `eval` é o resultado da última instrução. -For example: +Por exemplo: ```js run let value = eval('1+1'); alert(value); // 2 @@ -30,7 +30,7 @@ let value = eval('let i = 0; ++i'); alert(value); // 1 ``` -The eval'ed code is executed in the current lexical environment, so it can see outer variables: +O código executado pelo eval roda no Ambiente Léxico atual, então ele consegue ver as variáveis externas: ```js run no-beautify let a = 1; @@ -46,56 +46,56 @@ function f() { f(); ``` -It can change outer variables as well: +Ele também consegue mudar variáveis externas: ```js untrusted refresh run let x = 5; eval("x = 10"); -alert(x); // 10, value modified +alert(x); // 10, valor modificado ``` -In strict mode, `eval` has its own lexical environment. So functions and variables, declared inside eval, are not visible outside: +No modo estrito, `eval` tem seu próprio Ambiente Léxico. Então funções e variáveis declaradas dentro do eval não são visíveis fora: ```js untrusted refresh run -// reminder: 'use strict' is enabled in runnable examples by default +// lembrete: 'use strict' é ativado por padrão em exemplos executáveis eval("let x = 5; function f() {}"); -alert(typeof x); // undefined (no such variable) -// function f is also not visible +alert(typeof x); // undefined (essa variável não existe) +// a função f também não é visível ``` -Without `use strict`, `eval` doesn't have its own lexical environment, so we would see `x` and `f` outside. +Sem `use strict`, `eval` não tem seu próprio Ambiente Léxico, então veríamos `x` e `f` fora. -## Using "eval" +## Usando o "eval" -In modern programming `eval` is used very sparingly. It's often said that "eval is evil". +Na programação moderna, o `eval` é usado bem raramente. Costuma-se dizer que "eval is evil" ("eval é maligno"). -The reason is simple: long, long time ago JavaScript was a much weaker language, many things could only be done with `eval`. But that time passed a decade ago. +O motivo é simples: há muito, muito tempo, o JavaScript era uma linguagem bem mais fraca, e muitas coisas só podiam ser feitas com `eval`. Mas essa época passou há uma década. -Right now, there's almost no reason to use `eval`. If someone is using it, there's a good chance they can replace it with a modern language construct or a [JavaScript Module](info:modules). +Hoje em dia, quase não há motivo para usar `eval`. Se alguém está usando, há uma boa chance de que consiga substituir por uma construção moderna da linguagem ou um [Módulo JavaScript](info:modules). -Please note that its ability to access outer variables has side-effects. +Observe que sua capacidade de acessar variáveis externas tem efeitos colaterais. -Code minifiers (tools used before JS gets to production, to compress it) rename local variables into shorter ones (like `a`, `b` etc) to make the code smaller. That's usually safe, but not if `eval` is used, as local variables may be accessed from eval'ed code string. So minifiers don't do that renaming for all variables potentially visible from `eval`. That negatively affects code compression ratio. +Minificadores de código (ferramentas usadas antes do JS ir pra produção, pra comprimi-lo) renomeiam variáveis locais para nomes mais curtos (tipo `a`, `b` etc.) pra deixar o código menor. Isso normalmente é seguro, mas não quando `eval` é usado, já que variáveis locais podem ser acessadas a partir da string de código do eval. Então os minificadores não fazem essa renomeação para todas as variáveis potencialmente visíveis a partir do `eval`. Isso afeta negativamente a taxa de compressão do código. -Using outer local variables inside `eval` is also considered a bad programming practice, as it makes maintaining the code more difficult. +Usar variáveis locais externas dentro do `eval` também é considerado uma má prática de programação, já que torna a manutenção do código mais difícil. -There are two ways how to be totally safe from such problems. +Existem duas formas de ficar totalmente a salvo desses problemas. -**If eval'ed code doesn't use outer variables, please call `eval` as `window.eval(...)`:** +**Se o código executado pelo eval não usa variáveis externas, chame `eval` como `window.eval(...)`:** -This way the code is executed in the global scope: +Dessa forma, o código é executado no escopo global: ```js untrusted refresh run let x = 1; { let x = 5; - window.eval('alert(x)'); // 1 (global variable) + window.eval('alert(x)'); // 1 (variável global) } ``` -**If eval'ed code needs local variables, change `eval` to `new Function` and pass them as arguments:** +**Se o código executado pelo eval precisa de variáveis locais, troque `eval` por `new Function` e as passe como argumentos:** ```js run let f = new Function('a', 'alert(a)'); @@ -103,12 +103,12 @@ let f = new Function('a', 'alert(a)'); f(5); // 5 ``` -The `new Function` construct is explained in the chapter . It creates a function from a string, also in the global scope. So it can't see local variables. But it's so much clearer to pass them explicitly as arguments, like in the example above. +A construção `new Function` é explicada no capítulo . Ela cria uma função a partir de uma string, também no escopo global. Então ela não consegue ver variáveis locais. Mas é muito mais claro passá-las explicitamente como argumentos, como no exemplo acima. -## Summary +## Resumo -A call to `eval(code)` runs the string of code and returns the result of the last statement. -- Rarely used in modern JavaScript, as there's usually no need. -- Can access outer local variables. That's considered bad practice. -- Instead, to `eval` the code in the global scope, use `window.eval(code)`. -- Or, if your code needs some data from the outer scope, use `new Function` and pass it as arguments. +Uma chamada a `eval(code)` roda a string de código e retorna o resultado da última instrução. +- Raramente usado no JavaScript moderno, já que normalmente não há necessidade. +- Pode acessar variáveis locais externas. Isso é considerado má prática. +- Em vez disso, para executar o `eval` do código no escopo global, use `window.eval(code)`. +- Ou, se seu código precisa de alguns dados do escopo externo, use `new Function` e os passe como argumentos. From a72ac8cbbf4fe4b06e2a3d2cf127ba627427f04b Mon Sep 17 00:00:00 2001 From: Diogo Marciano Date: Sat, 21 Nov 2026 14:45:15 -0300 Subject: [PATCH 2/2] Apply review feedback from @gabifs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Fix title: "Eval: executa uma string de código" -> "Eval: executando uma string de código" (noun/infinitive style used by other titles) - Standardize "Ambiente Léxico" -> "Ambiente Lexical", matching the term used elsewhere in the repo (linked from ) - Standardize informal "pra" to "para" and "tipo" to "como" - Fix truncated phrasing: "executar o eval do código" -> "executar o código com eval" - Fix inverted meaning: "limitar só a aritmética" -> "limitá-la apenas à aritmética" - Drop the stray "?" from the imperative prompt() question Co-Authored-By: Claude Sonnet 5 --- .../99-js-misc/02-eval/1-eval-calculator/solution.md | 4 ++-- 1-js/99-js-misc/02-eval/article.md | 12 ++++++------ 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md b/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md index b86786ae0..f09b7e47e 100644 --- a/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md +++ b/1-js/99-js-misc/02-eval/1-eval-calculator/solution.md @@ -1,11 +1,11 @@ Vamos usar `eval` para calcular a expressão matemática: ```js demo run -let expr = prompt("Digite uma expressão aritmética?", '2*3+2'); +let expr = prompt("Digite uma expressão aritmética:", '2*3+2'); alert( eval(expr) ); ``` Porém, o usuário pode digitar qualquer texto ou código. -Para deixar as coisas seguras, e limitar só a aritmética, podemos verificar `expr` usando uma [expressão regular](info:regular-expressions), de forma que ela só possa conter dígitos e operadores. +Para deixar as coisas seguras e limitá-la apenas à aritmética, podemos verificar `expr` usando uma [expressão regular](info:regular-expressions), de forma que ela só possa conter dígitos e operadores. diff --git a/1-js/99-js-misc/02-eval/article.md b/1-js/99-js-misc/02-eval/article.md index 9b9f99b18..24c68b8de 100644 --- a/1-js/99-js-misc/02-eval/article.md +++ b/1-js/99-js-misc/02-eval/article.md @@ -1,4 +1,4 @@ -# Eval: executa uma string de código +# Eval: executando uma string de código A função nativa `eval` permite executar uma string de código. @@ -30,7 +30,7 @@ let value = eval('let i = 0; ++i'); alert(value); // 1 ``` -O código executado pelo eval roda no Ambiente Léxico atual, então ele consegue ver as variáveis externas: +O código executado pelo eval roda no Ambiente Lexical atual, então ele consegue ver as variáveis externas: ```js run no-beautify let a = 1; @@ -54,7 +54,7 @@ eval("x = 10"); alert(x); // 10, valor modificado ``` -No modo estrito, `eval` tem seu próprio Ambiente Léxico. Então funções e variáveis declaradas dentro do eval não são visíveis fora: +No modo estrito, `eval` tem seu próprio Ambiente Lexical. Então funções e variáveis declaradas dentro do eval não são visíveis fora: ```js untrusted refresh run // lembrete: 'use strict' é ativado por padrão em exemplos executáveis @@ -65,7 +65,7 @@ alert(typeof x); // undefined (essa variável não existe) // a função f também não é visível ``` -Sem `use strict`, `eval` não tem seu próprio Ambiente Léxico, então veríamos `x` e `f` fora. +Sem `use strict`, `eval` não tem seu próprio Ambiente Lexical, então veríamos `x` e `f` fora. ## Usando o "eval" @@ -77,7 +77,7 @@ Hoje em dia, quase não há motivo para usar `eval`. Se alguém está usando, h Observe que sua capacidade de acessar variáveis externas tem efeitos colaterais. -Minificadores de código (ferramentas usadas antes do JS ir pra produção, pra comprimi-lo) renomeiam variáveis locais para nomes mais curtos (tipo `a`, `b` etc.) pra deixar o código menor. Isso normalmente é seguro, mas não quando `eval` é usado, já que variáveis locais podem ser acessadas a partir da string de código do eval. Então os minificadores não fazem essa renomeação para todas as variáveis potencialmente visíveis a partir do `eval`. Isso afeta negativamente a taxa de compressão do código. +Minificadores de código (ferramentas usadas antes do JS ir para produção, para comprimi-lo) renomeiam variáveis locais para nomes mais curtos (como `a`, `b` etc.) para deixar o código menor. Isso normalmente é seguro, mas não quando `eval` é usado, já que variáveis locais podem ser acessadas a partir da string de código do eval. Então os minificadores não fazem essa renomeação para todas as variáveis potencialmente visíveis a partir do `eval`. Isso afeta negativamente a taxa de compressão do código. Usar variáveis locais externas dentro do `eval` também é considerado uma má prática de programação, já que torna a manutenção do código mais difícil. @@ -110,5 +110,5 @@ A construção `new Function` é explicada no capítulo . Ela Uma chamada a `eval(code)` roda a string de código e retorna o resultado da última instrução. - Raramente usado no JavaScript moderno, já que normalmente não há necessidade. - Pode acessar variáveis locais externas. Isso é considerado má prática. -- Em vez disso, para executar o `eval` do código no escopo global, use `window.eval(code)`. +- Em vez disso, para executar o código com `eval` no escopo global, use `window.eval(code)`. - Ou, se seu código precisa de alguns dados do escopo externo, use `new Function` e os passe como argumentos.