Skip to content

Commit b681b75

Browse files
chore: translate the native prototypes article
Native prototypes
2 parents 6cd1cce + 06ba0db commit b681b75

File tree

5 files changed

+83
-83
lines changed

5 files changed

+83
-83
lines changed

Diff for: 1-js/08-prototypes/03-native-prototypes/1-defer-to-prototype/solution.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ Function.prototype.defer = function(ms) {
66
};
77

88
function f() {
9-
alert("Hello!");
9+
alert("Olá!");
1010
}
1111

12-
f.defer(1000); // shows "Hello!" after 1 sec
12+
f.defer(1000); // mostra "Olá!" depois de 1 segundo
1313
```

Diff for: 1-js/08-prototypes/03-native-prototypes/1-defer-to-prototype/task.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,16 @@ importance: 5
22

33
---
44

5-
# Add method "f.defer(ms)" to functions
5+
# Adicione o método "f.defer(ms)" às funções
66

7-
Add to the prototype of all functions the method `defer(ms)`, that runs the function after `ms` milliseconds.
7+
Adicione ao protótipo de todas as funções o método `defer(ms)`, que executa a função depois de `ms` milisegundos.
88

9-
After you do it, such code should work:
9+
Depois de fazer isso, esse código deve funcionar:
1010

1111
```js
1212
function f() {
13-
alert("Hello!");
13+
alert("Olá!");
1414
}
1515

16-
f.defer(1000); // shows "Hello!" after 1 second
16+
f.defer(1000); // mostra "Olá!" depois de 1 segundo
1717
```

Diff for: 1-js/08-prototypes/03-native-prototypes/2-defer-to-prototype-extended/solution.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,17 @@ Function.prototype.defer = function(ms) {
88
}
99
};
1010

11-
// check it
11+
// confira
1212
function f(a, b) {
1313
alert( a + b );
1414
}
1515

16-
f.defer(1000)(1, 2); // shows 3 after 1 sec
16+
f.defer(1000)(1, 2); // mostra 3 depois de 1 segundo
1717
```
1818

19-
Please note: we use `this` in `f.apply` to make our decoration work for object methods.
19+
Note que: nós usamos `this` no `f.apply` para nossa decoração funcionar para métodos de objetos.
2020

21-
So if the wrapper function is called as an object method, then `this` is passed to the original method `f`.
21+
Então, se a função *wrapper* for chamada como um método de objeto, o `this` é passado para o método `f` original.
2222

2323
```js run
2424
Function.prototype.defer = function(ms) {

Diff for: 1-js/08-prototypes/03-native-prototypes/2-defer-to-prototype-extended/task.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,18 @@ importance: 4
22

33
---
44

5-
# Add the decorating "defer()" to functions
5+
# Adicione o decorador "defer()" às funções
66

7-
Add to the prototype of all functions the method `defer(ms)`, that returns a wrapper, delaying the call by `ms` milliseconds.
7+
Adicione ao protótipo de todas as funções o método `defer(ms)` que retorne um *wrapper* (invólucro), atrasando a chamada em `ms` milisegundos.
88

9-
Here's an example of how it should work:
9+
Aqui está um exemplo de como deveria funcionar:
1010

1111
```js
1212
function f(a, b) {
1313
alert( a + b );
1414
}
1515

16-
f.defer(1000)(1, 2); // shows 3 after 1 second
16+
f.defer(1000)(1, 2); // mostra 3 depois de 1 segundo
1717
```
1818

19-
Please note that the arguments should be passed to the original function.
19+
Note que os argumentos devem ser passados para a função original.

Diff for: 1-js/08-prototypes/03-native-prototypes/article.md

+67-67
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
1-
# Native prototypes
1+
# Protótipos Nativos
22

3-
The `"prototype"` property is widely used by the core of JavaScript itself. All built-in constructor functions use it.
3+
A propriedade `"prototype"` é amplamente utilizada pelo próprio núcleo do JavaScript. Todas as funções construtoras integradas o utilizam.
44

5-
First we'll look at the details, and then how to use it for adding new capabilities to built-in objects.
5+
Primeiro veremos os detalhes e depois como usá-lo para adicionar novos recursos a objetos integrados.
66

77
## Object.prototype
88

9-
Let's say we output an empty object:
9+
Digamos que produzimos um objeto vazio:
1010

1111
```js run
1212
let obj = {};
1313
alert( obj ); // "[object Object]" ?
1414
```
1515

16-
Where's the code that generates the string `"[object Object]"`? That's a built-in `toString` method, but where is it? The `obj` is empty!
16+
Onde está o código que gera a string `"[object Object]"`? Isto vem de um método embutido `toString`, mas onde ele está? O `obj` está vazio!
1717

18-
...But the short notation `obj = {}` is the same as `obj = new Object()`, where `Object` is a built-in object constructor function, with its own `prototype` referencing a huge object with `toString` and other methods.
18+
... A notação abreviada `obj = {}` é o mesmo que `obj = new Object()`. Onde `Object` é uma função construtora embutida, com o seu próprio `prototype` referenciando um objeto enorme, possuindo `toString` e outros métodos.
1919

20-
Here's what's going on:
20+
Veja o que está acontecendo:
2121

2222
![](object-prototype.svg)
2323

24-
When `new Object()` is called (or a literal object `{...}` is created), the `[[Prototype]]` of it is set to `Object.prototype` according to the rule that we discussed in the previous chapter:
24+
Quando `new Object()` é invocado (ou um objeto literal `{...}` é criado), o seu `[[Prototype]]` é configurado para o `Object.prototype`, de acordo com a regra que nós discutimos no capítulo anterior:
2525

2626
![](object-prototype-1.svg)
2727

28-
So then when `obj.toString()` is called the method is taken from `Object.prototype`.
28+
Assim, quando `obj.toString()` é chamado, o método é obtido de `Object.prototype`.
2929

30-
We can check it like this:
30+
Nós podemos conferir isso assim:
3131

3232
```js run
3333
let obj = {};
@@ -38,115 +38,115 @@ alert(obj.toString === obj.__proto__.toString); //true
3838
alert(obj.toString === Object.prototype.toString); //true
3939
```
4040

41-
Please note that there is no more `[[Prototype]]` in the chain above `Object.prototype`:
41+
Observe que não há mais `[[Prototype]]` na cadeia acima de `Object.prototype`:
4242

4343
```js run
4444
alert(Object.prototype.__proto__); // null
4545
```
4646

47-
## Other built-in prototypes
47+
## Outros protótipos embutidos
4848

49-
Other built-in objects such as `Array`, `Date`, `Function` and others also keep methods in prototypes.
49+
Outros objetos embutidos, como `Array`, `Date`, `Function`, etc., também têm métodos nos seus protótipos.
5050

51-
For instance, when we create an array `[1, 2, 3]`, the default `new Array()` constructor is used internally. So `Array.prototype` becomes its prototype and provides methods. That's very memory-efficient.
51+
Por exemplo, quando criamos um array `[1, 2, 3]`, o construtor padrão `new Array()` é usado internamente. Então `Array.prototype` se torna seu protótipo e fornece métodos. Isso é muito eficiente em termos de memória.
5252

53-
By specification, all of the built-in prototypes have `Object.prototype` on the top. That's why some people say that "everything inherits from objects".
53+
Por especificação, todos os protótipos integrados têm `Object.prototype` no topo. É por isso que algumas pessoas dizem que “tudo herda dos objetos”.
5454

55-
Here's the overall picture (for 3 built-ins to fit):
55+
Aqui temos uma visão geral (para 3 protótipos embutidos):
5656

5757
![](native-prototypes-classes.svg)
5858

59-
Let's check the prototypes manually:
59+
Vamos conferir os protótipos manualmente:
6060

6161
```js run
6262
let arr = [1, 2, 3];
6363

64-
// it inherits from Array.prototype?
64+
// herda de Array.prototype?
6565
alert( arr.__proto__ === Array.prototype ); // true
6666

67-
// then from Object.prototype?
67+
// a seguir herda de Object.prototype?
6868
alert( arr.__proto__.__proto__ === Object.prototype ); // true
6969

70-
// and null on the top.
70+
// e null no topo.
7171
alert( arr.__proto__.__proto__.__proto__ ); // null
7272
```
7373

74-
Some methods in prototypes may overlap, for instance, `Array.prototype` has its own `toString` that lists comma-delimited elements:
74+
Alguns métodos nos protótipos podem se sobrepor. Por exemplo, `Array.prototype` tem o seu próprio `toString` que lista os elementos separados por vírgula:
7575

7676
```js run
7777
let arr = [1, 2, 3]
78-
alert(arr); // 1,2,3 <-- the result of Array.prototype.toString
78+
alert(arr); // 1,2,3 <-- O resultado de Array.prototype.toString
7979
```
8080

81-
As we've seen before, `Object.prototype` has `toString` as well, but `Array.prototype` is closer in the chain, so the array variant is used.
81+
Como vimos antes, `Object.prototype` também tem o método `toString`, mas `Array.prototype` está mais perto na cadeia, então a variante do array é utilizada.
8282

8383

8484
![](native-prototypes-array-tostring.svg)
8585

8686

87-
In-browser tools like Chrome developer console also show inheritance (`console.dir` may need to be used for built-in objects):
87+
Ferramentas embutidas em navegadores, como o console do desenvolvedor no Chrome, também mostram herança (para objetos embutidos pode ser preciso usar `console.dir`):
8888

8989
![](console_dir_array.png)
9090

91-
Other built-in objects also work the same way. Even functions -- they are objects of a built-in `Function` constructor, and their methods (`call`/`apply` and others) are taken from `Function.prototype`. Functions have their own `toString` too.
91+
Outros objetos embutidos também trabalham da mesma forma. Até mesmo funções -- elas são objetos de um construtor `Function` embutido, e os seus métodos (`call`/`apply`, e outros) são obtidos de `Function.prototype`. Funções também têm o seu próprio `toString`.
9292

9393
```js run
9494
function f() {}
9595

9696
alert(f.__proto__ == Function.prototype); // true
97-
alert(f.__proto__.__proto__ == Object.prototype); // true, inherit from objects
97+
alert(f.__proto__.__proto__ == Object.prototype); // true, herdado de object
9898
```
9999

100-
## Primitives
100+
## Primitivos
101101

102-
The most intricate thing happens with strings, numbers and booleans.
102+
As coisas mais complicadas acontecem com strings, números e boleanos.
103103

104-
As we remember, they are not objects. But if we try to access their properties, temporary wrapper objects are created using built-in constructors `String`, `Number` and `Boolean`. They provide the methods and disappear.
104+
Como sabemos, eles não são objetos. Mas se nós tentarmos acessar as propriedades deles, temporariamente são criados objetos usando os construtores embutidos `String`, `Number` and `Boolean`. Esses objetos fornecem os métodos e desaparecem.
105105

106-
These objects are created invisibly to us and most engines optimize them out, but the specification describes it exactly this way. Methods of these objects also reside in prototypes, available as `String.prototype`, `Number.prototype` and `Boolean.prototype`.
106+
Esses objetos são criados invisivelmente para nós e a maioria dos interpretadores (*engines*) otimizam esse processo, apesar da especificação descrevê-lo exatamente desta forma. Os métodos desses objetos também residem nos protótipos, disponíveis como `String.prototype`, `Number.prototype` e `Boolean.prototype`.
107107

108-
```warn header="Values `null` and `undefined` have no object wrappers"
109-
Special values `null` and `undefined` stand apart. They have no object wrappers, so methods and properties are not available for them. And there are no corresponding prototypes either.
108+
```warn header="Os valores `null` e `undefined` não têm objetos que os envolvam"
109+
O valores especiais `null` e `undefined` se destacam dos outros. Eles não têm objetos que os envolem, então métodos e propriedades não estão disponíveis para eles. Também não existem protótipos correspondentes.
110110
```
111111
112-
## Changing native prototypes [#native-prototype-change]
112+
## Mudando protótipos nativos [#native-prototype-change]
113113
114-
Native prototypes can be modified. For instance, if we add a method to `String.prototype`, it becomes available to all strings:
114+
Protótipos nativos podem ser modificados. Por exemplo, se nós adicionarmos um método a `String.prototype`, ele vai ficar disponível a todas as strings:
115115
116116
```js run
117117
String.prototype.show = function() {
118118
alert(this);
119119
};
120120
121-
"BOOM!".show(); // BOOM!
121+
"BUM!".show(); // BUM!
122122
```
123123

124-
During the process of development, we may have ideas for new built-in methods we'd like to have, and we may be tempted to add them to native prototypes. But that is generally a bad idea.
124+
Durante o processo de desenvolvimento, nós podemos ter novas ideias de métodos embutidos que gostaríamos de ter, e podemos ficar tentados a adicioná-los aos protótipos nativos. Mas isso é geralmente uma má ideia.
125125

126126
```warn
127-
Prototypes are global, so it's easy to get a conflict. If two libraries add a method `String.prototype.show`, then one of them will be overwriting the method of the other.
127+
Os protótipos são globais, por isso é fácil criar conflitos. Se duas bibliotecas adicionarem um método `String.prototype.show`, então uma delas substituirá o método da outra.
128128
129-
So, generally, modifying a native prototype is considered a bad idea.
129+
Por isso, geralmente, modificar um protótipo nativo é considerado uma má ideia.
130130
```
131131

132-
**In modern programming, there is only one case where modifying native prototypes is approved. That's polyfilling.**
132+
**Na programação moderna, existe apenas um caso erm que modificar protótipos nativos é aprovado: fazer polyfill (polyfilling).**
133133

134-
Polyfilling is a term for making a substitute for a method that exists in the JavaScript specification, but is not yet supported by a particular JavaScript engine.
134+
*Polyfill* é um termo para criar um substituto para um método que existe na especificação, mas que ainda não tem suporte em um particular interpretador de JavaScript.
135135

136-
We may then implement it manually and populate the built-in prototype with it.
136+
Nesse caso nós o podemos implementar e preencher o protótipo embutido com ele.
137137

138-
For instance:
138+
Por exemplo:
139139

140140
```js run
141-
if (!String.prototype.repeat) { // if there's no such method
142-
// add it to the prototype
141+
if (!String.prototype.repeat) { // Se não existe esse método
142+
// adiciona ao protótipo
143143

144144
String.prototype.repeat = function(n) {
145-
// repeat the string n times
145+
// repete a string n vezes
146146

147-
// actually, the code should be a little bit more complex than that
148-
// (the full algorithm is in the specification)
149-
// but even an imperfect polyfill is often considered good enough
147+
// na realidade, o código deveria ser um pouco mais complexo do que isso
148+
// (o algoritmo completo está na especificação)
149+
// mas mesmo um polyfill imperfeito, é geralmente considerado bom o suficiente
150150
return new Array(n + 1).join(this);
151151
};
152152
}
@@ -155,44 +155,44 @@ alert( "La".repeat(3) ); // LaLaLa
155155
```
156156

157157

158-
## Borrowing from prototypes
158+
## Pegando emprestado dos protótipos
159159

160-
In the chapter <info:call-apply-decorators#method-borrowing> we talked about method borrowing.
160+
No capítulo <info:call-apply-decorators#method-borrowing>, nós falamos sobre pegar métodos emprestados.
161161

162-
That's when we take a method from one object and copy it into another.
162+
Isso é quando nós pegamos um método de um objeto e o copiamos para outro.
163163

164-
Some methods of native prototypes are often borrowed.
164+
Alguns métodos de protótipos nativos são emprestados com muita frequência.
165165

166-
For instance, if we're making an array-like object, we may want to copy some `Array` methods to it.
166+
Por exemplo, se estivermos criando um objeto semelhante a um array, podemos querer copiar alguns métodos `Array` para ele.
167167

168-
E.g.
168+
Veja um exemplo:
169169

170170
```js run
171171
let obj = {
172-
0: "Hello",
173-
1: "world!",
172+
0: "Olá",
173+
1: "mundo!",
174174
length: 2,
175175
};
176176

177177
*!*
178178
obj.join = Array.prototype.join;
179179
*/!*
180180

181-
alert( obj.join(',') ); // Hello,world!
181+
alert( obj.join(',') ); // Olá,mundo!
182182
```
183183

184-
It works because the internal algorithm of the built-in `join` method only cares about the correct indexes and the `length` property. It doesn't check if the object is indeed an array. Many built-in methods are like that.
184+
Ele funciona porque o algoritmo interno do método `join` embutido só precisa dos índices corretos e da propriedade `length`. Ele não confere se o objeto é de fato uma array. Muitos métodos enbutidos são assim.
185185

186-
Another possibility is to inherit by setting `obj.__proto__` to `Array.prototype`, so all `Array` methods are automatically available in `obj`.
186+
Outra possibilidade é herdando, configurando `obj.__proto__` para `Array.prototype`, de forma que todos os métodos de `Array` fiquem automaticamente disponíveis em `obj`.
187187

188-
But that's impossible if `obj` already inherits from another object. Remember, we only can inherit from one object at a time.
188+
Mas isso é impossível se `obj` já herda de outro objeto. Lembre-se, nós só podemos herdar de um objeto por vez.
189189

190-
Borrowing methods is flexible, it allows to mix functionalities from different objects if needed.
190+
Pegar métodos emprestados é mais flexível, isso permite misturar as funcionalidades de diferentes objetos caso necessário.
191191

192-
## Summary
192+
## Resumo
193193

194-
- All built-in objects follow the same pattern:
195-
- The methods are stored in the prototype (`Array.prototype`, `Object.prototype`, `Date.prototype`, etc.)
196-
- The object itself stores only the data (array items, object properties, the date)
197-
- Primitives also store methods in prototypes of wrapper objects: `Number.prototype`, `String.prototype` and `Boolean.prototype`. Only `undefined` and `null` do not have wrapper objects
198-
- Built-in prototypes can be modified or populated with new methods. But it's not recommended to change them. The only allowable case is probably when we add-in a new standard, but it's not yet supported by the JavaScript engine
194+
- Todos os objetos embutidos seguem o mesmo padrão:
195+
- Os métodos são guardados no protótipo (`Array.prototype`, `Object.prototype`, `Date.prototype`, etc.)
196+
- O objeto só guarda os dados nele mesmo (itens de array, propriedades de objetos, uma data)
197+
- Tipos primitivos também guardam métodos em protótipos de objetos que os envolvem: `Number.prototype`, `String.prototype` e `Boolean.prototype`. Apenas `undefined` e `null` não tem objetos invólucros.
198+
- Protótipos embutidos podem ser modificados ou populados com novos métodos. Mas modificá-los não é recomendado. O único caso aceitável, é provavelmente quando nós adicionamos um novo comportamento que ainda não tem suporte em algum interpretador (*engine*) de JavaScript.

0 commit comments

Comments
 (0)