Skip to content

Commit cd8a26d

Browse files
committed
Merge branch 'conflicts-check-after-pr178' of https://github.com/odsantos/pt.javascript.info into conflicts-check-after-pr178
2 parents a68a02b + c805933 commit cd8a26d

File tree

6 files changed

+31
-30
lines changed

6 files changed

+31
-30
lines changed

1-js/02-first-steps/04-variables/article.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ let message;
3535
message = 'Olá!';
3636

3737
*!*
38-
alert(message); // mostra o conteúdo variável
38+
alert(message); // mostra o conteúdo da variável
3939
*/!*
4040
```
4141

@@ -94,13 +94,13 @@ Existem diferenças sutis entre `let` e `var`, mas elas ainda não são importan
9494
9595
## Uma analogia da vida real
9696
97-
Podemos facilmente compreender o conceito de uma "variável" se a imaginarmos como uma "box" de dados, com um adesivo de nome exclusivo.
97+
Podemos facilmente compreender o conceito de uma "variável" se a imaginarmos como uma "caixa" para dados, com um adesivo de nome exclusivo.
9898
99-
Por exemplo, a variável `mensagem` pode ser imaginada como uma box chamada `"message"`com o valor `"Olá"`!:
99+
Por exemplo, a variável `mensagem` pode ser imaginada como uma caixa chamada `"message"`com o valor `"Olá"`!:
100100
101101
![](variable.svg)
102102
103-
Podemos pôr qualquer valor na box.
103+
Podemos pôr qualquer valor na caixa.
104104
105105
Também podemos mudá-lo quantas vezes quisermos:
106106
```js run
@@ -129,7 +129,7 @@ let message;
129129
message = hello;
130130
*/!*
131131
132-
// agora duas variáveis mantêm os mesmos dados
132+
// agora duas variáveis contêm os mesmos dados
133133
alert(hello); // Olá Mundo!
134134
alert(message); // Olá Mundo!
135135
```
@@ -151,7 +151,7 @@ Assim, devemos declarar uma variável apenas uma vez e depois fazer referência
151151
```smart header="Linguagens funcionais"
152152
É interessante notar que existem linguagens de programação [funcionais](https://en.wikipedia.org/wiki/Functional_programming), como [Scala](http://www.scala-lang.org/) ou [Erlang](http://www.erlang.org/), que proíbem a modificação de valores de variáveis.
153153
154-
Em tais linguagens, uma vez que o valor é armazenado "na box", ele está lá para sempre. Se precisarmos de armazenar algo mais, a linguagem nos obriga a criar uma nova box (declarar uma nova variável). Não podemos reutilizar a antiga.
154+
Em tais linguagens, uma vez que o valor é armazenado "na caixa", ele está lá para sempre. Se precisarmos de armazenar algo mais, a linguagem nos obriga a criar uma nova caixa (declarar uma nova variável). Não podemos reutilizar a antiga.
155155
156156
Embora possa parecer um pouco estranho à primeira vista, estas linguagens são bastante capazes de um desenvolvimento sério. Mais do que isso, há áreas como cálculos paralelos onde essa limitação confere certos benefícios. Estudar alguma dessas linguagens (mesmo que você não esteja planejando usá-la em breve) é recomendado para ampliar a mente.
157157
```
@@ -195,8 +195,8 @@ let my-name; // hífens '-' não são permitidos no nome
195195
Variáveis chamadas `apple` e `AppLE` são duas variáveis diferentes.
196196
```
197197

198-
````smart header="Letras de alfabeto não-Latin são permitidas, mas não são recomendadas"
199-
É possível usar qualquer idioma, incluindo letras cirílicas ou até hieróglifos, como este:
198+
````smart header="Letras não-Latin são permitidas, mas não são recomendadas"
199+
É possível usar qualquer idioma, incluindo letras cirílicas ou até hieróglifos, como estes:
200200
201201
```js
202202
let имя = '...';
@@ -237,7 +237,7 @@ Esta é uma má prática e causaria um erro no modo estrito:
237237
"use strict";
238238

239239
*!*
240-
num = 5; // erro: o número não está definido
240+
num = 5; // erro: 'num' não está definido
241241
*/!*
242242
```
243243
````
@@ -303,7 +303,7 @@ Em outras palavras, constantes com nomes maiúsculos são usadas apenas como pse
303303
304304
Falando em variáveis, há mais uma coisa extremamente importante.
305305
306-
O nome de uma variável deve ter um significado claro e óbvio, descrevendo os dados que ela armazena.
306+
O nome de uma variável deveria ter um significado claro e óbvio, descrevendo os dados que ela armazena.
307307
308308
A nomenclatura variável é uma das habilidades mais importantes e complexas em programação. Uma rápida olhada em nomes de variáveis pode revelar que código foi escrito por um iniciante versus um desenvolvedor experiente.
309309
@@ -336,7 +336,7 @@ Os minificadores e navegadores JavaScript modernos otimizam o código o suficien
336336
337337
Podemos declarar variáveis para armazenar dados usando as palavras-chave `var`, `let`, ou `const`.
338338
339-
- `let` -- é uma declaração de variável moderna. O código deve estar em modo estrito para usar `let` no Chrome (V8).
339+
- `let` -- é uma declaração de variável moderna.
340340
- `var` -- é uma declaração de variável da velha escola. Normalmente não a usamos de todo, mas vamos cobrir diferenças sutis de `let` no capítulo <info:var>, para o caso de você precisar delas.
341341
- `const` -- é como `let`, mas o valor da variável não pode ser alterado.
342342

1-js/02-first-steps/05-types/article.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ Além dos números regulares, existem os chamados "valores numéricos especiais"
3535
alert( 1 / 0 ); // Infinito
3636
```
3737

38-
Ou apenas referi-lo directamente:
38+
Ou apenas referi-lo diretamente:
3939

4040
```js run
4141
alert( Infinity ); // Infinito
@@ -178,7 +178,7 @@ O valor especial `undefined` também se diferencia. Faz um tipo próprio, tal co
178178
179179
O significado de `undefined` é "o valor não é atribuído".
180180
181-
Se uma variável é declarada, mas não atribuida, então seu valor é `undefined`:
181+
Se uma variável é declarada, mas não atribuída, então seu valor é `undefined`:
182182
183183
```js run
184184
let age;
@@ -252,7 +252,7 @@ As três últimas linhas podem precisar de explicações adicionais:
252252
253253
1. `Math` é um objeto embutido que fornece operações matemáticas. Nós o vamos aprender no capítulo <info:number>. Aqui, ele serve apenas como um exemplo de um objeto.
254254
2. O resultado de `typeof null` é `"object"`. É um erro oficialmente reconhecido no comportamento de `typeof` e mantido para compatibilidade. Naturalmente, `null` não é um objeto. É um valor especial com um tipo separado próprio.
255-
3. O resultado de `typeof alert` é `"function"`, porque `alert` é uma função. Vamos estudar as funções nos próximos capítulos onde veremos tambémm que não há nenhum tipo especial "função" em JavaScript. As funções pertencem ao tipo objecto. Mas o `typeof` as trata de forma diferente, retornando `"function"`. Isto, também vem dos primeiros dias do JavaScript. Tecnicamente, é incorrecto, mas muito conveniente na prática.
255+
3. O resultado de `typeof alert` é `"function"`, porque `alert` é uma função. Vamos estudar as funções nos próximos capítulos onde veremos também que não há nenhum tipo especial "função" em JavaScript. As funções pertencem ao tipo objecto. Mas o `typeof` as trata de forma diferente, retornando `"function"`. Isto, também vem dos primeiros dias do JavaScript. Tecnicamente, é incorreto, mas muito conveniente na prática.
256256
257257
## Resumo
258258

1-js/02-first-steps/08-operators/article.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -172,11 +172,11 @@ Why are unary pluses applied to values before the binary ones? As we're going to
172172
173173
## Operator precedence
174174
175-
If an expression has more than one operator, the execution order is defined by their *precedence*, or, in other words, the implicit priority order of operators.
175+
If an expression has more than one operator, the execution order is defined by their *precedence*, or, in other words, the default priority order of operators.
176176
177177
From school, we all know that the multiplication in the expression `1 + 2 * 2` should be calculated before the addition. That's exactly the precedence thing. The multiplication is said to have *a higher precedence* than the addition.
178178

179-
Parentheses override any precedence, so if we're not satisfied with the implicit order, we can use them to change it. For example: `(1 + 2) * 2`.
179+
Parentheses override any precedence, so if we're not satisfied with the default order, we can use them to change it. For example, write `(1 + 2) * 2`.
180180
181181
There are many operators in JavaScript. Every operator has a corresponding precedence number. The one with the larger number executes first. If the precedence is the same, the execution order is from left to right.
182182
@@ -232,7 +232,7 @@ alert( a ); // 3
232232
alert( c ); // 0
233233
```
234234
235-
In the example above, the result of `(a = b + 1)` is the value which is assigned to `a` (that is `3`). It is then used for further evaluations.
235+
In the example above, the result of expression `(a = b + 1)` is the value which was assigned to `a` (that is `3`). It is then used for further evaluations.
236236
237237
Funny code, isn't it? We should understand how it works, because sometimes we see it in JavaScript libraries.
238238

@@ -311,14 +311,14 @@ So, there are special operators for it:
311311
312312
```js run no-beautify
313313
let counter = 2;
314-
counter++; // works the same as counter = counter + 1, but is shorter
314+
counter++; // works the same as counter = counter + 1, but is shorter
315315
alert( counter ); // 3
316316
```
317317
- **Decrement** `--` decreases a variable by 1:
318318
319319
```js run no-beautify
320320
let counter = 2;
321-
counter--; // works the same as counter = counter - 1, but is shorter
321+
counter--; // works the same as counter = counter - 1, but is shorter
322322
alert( counter ); // 1
323323
```
324324
@@ -451,10 +451,10 @@ Here, the first expression `1 + 2` is evaluated and its result is thrown away. T
451451
```smart header="Comma has a very low precedence"
452452
Please note that the comma operator has very low precedence, lower than `=`, so parentheses are important in the example above.
453453
454-
Without them: `a = 1 + 2, 3 + 4` evaluates `+` first, summing the numbers into `a = 3, 7`, then the assignment operator `=` assigns `a = 3`, and finally the number after the comma, `7`, is not processed so it's ignored.
454+
Without them: `a = 1 + 2, 3 + 4` evaluates `+` first, summing the numbers into `a = 3, 7`, then the assignment operator `=` assigns `a = 3`, and the rest is ignored. It's like `(a = 1 + 2), 3 + 4`.
455455
```
456456

457-
Why do we need an operator that throws away everything except the last part?
457+
Why do we need an operator that throws away everything except the last expression?
458458

459459
Sometimes, people use it in more complex constructs to put several actions in one line.
460460

@@ -467,4 +467,4 @@ for (*!*a = 1, b = 3, c = a * b*/!*; a < 10; a++) {
467467
}
468468
```
469469

470-
Such tricks are used in many JavaScript frameworks. That's why we're mentioning them. But, usually, they don't improve code readability so we should think well before using them.
470+
Such tricks are used in many JavaScript frameworks. That's why we're mentioning them. But usually they don't improve code readability so we should think well before using them.

1-js/02-first-steps/09-comparison/1-comparison-questions/task.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,3 +15,4 @@ undefined === null
1515
null == "\n0\n"
1616
null === +"\n0\n"
1717
```
18+
Lines changed: 1 addition & 1 deletion
Loading

1-js/02-first-steps/10-ifelse/article.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22

33
Sometimes, we need to perform different actions based on different conditions.
44

5-
To do that, we use the `if` statement and the conditional (ternary) operator which we will be referring to as the “question mark operator `?` for simplicity.
5+
To do that, we can use the `if` statement and the conditional operator `?`, that's also called a "question mark" operator.
66

77
## The "if" statement
88

9-
The `if` statement evaluates a condition and, if the condition's result is `true`, executes a block of code.
9+
The `if(...)` statement evaluates a condition in parentheses and, if the result is `true`, executes a block of code.
1010

1111
For example:
1212

@@ -103,7 +103,7 @@ In the code above, JavaScript first checks `year < 2015`. If that is falsy, it g
103103

104104
There can be more `else if` blocks. The final `else` is optional.
105105

106-
## Ternary operator '?'
106+
## Conditional operator '?'
107107

108108
Sometimes, we need to assign a variable depending on a condition.
109109

@@ -124,9 +124,9 @@ if (age > 18) {
124124
alert(accessAllowed);
125125
```
126126

127-
The so-called "ternary" or "question mark" operator lets us do that in a shorter and simpler way.
127+
The so-called "conditional" or "question mark" operator lets us do that in a shorter and simpler way.
128128

129-
The operator is represented by a question mark `?`. The formal term "ternary" means that the operator has three operands. It is actually the one and only operator in JavaScript which has that many.
129+
The operator is represented by a question mark `?`. Sometimes it's called "ternary", because the operator has three operands. It is actually the one and only operator in JavaScript which has that many.
130130

131131
The syntax is:
132132
```js
@@ -141,7 +141,7 @@ For example:
141141
let accessAllowed = (age > 18) ? true : false;
142142
```
143143

144-
Technically, we can omit the parentheses around `age > 18`. The question mark operator has a low precedence, so it executes after the comparison `>`.
144+
Technically, we can omit the parentheses around `age > 18`. The question mark operator has a low precedence, so it executes after the comparison `>`.
145145

146146
This example will do the same thing as the previous one:
147147

@@ -216,7 +216,7 @@ Depending on the condition `company == 'Netscape'`, either the first or the seco
216216

217217
We don't assign a result to a variable here. Instead, we execute different code depending on the condition.
218218

219-
**We don't recommend using the question mark operator in this way.**
219+
**It's not recommended to use the question mark operator in this way.**
220220

221221
The notation is shorter than the equivalent `if` statement, which appeals to some programmers. But it is less readable.
222222

0 commit comments

Comments
 (0)