Skip to content

Commit fd11cbc

Browse files
committed
appendix/fromtranslators + object/hasownproperty
1 parent 541083a commit fd11cbc

7 files changed

Lines changed: 49 additions & 46 deletions

File tree

‎doc/ru/appendix/fromtranslators.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
## От переводчиков
2+
3+
Авторы этой документации требуют от читателя не совершать каких-либо ошибок и постоянно следить за качеством пишущегося кода. Мы, как переводчики и опытные программисты на JavaScript рекомендуем *прислушиваться* к этим советам, но при этом не делать из этого *крайность*. Опыт — сын ошибок трудных, и иногда в борьбе с ошибками зарождается намного более детальное понимание предмета. Да, нужно избегать ошибок, но допускать их неосознанно — вполне нормально.
4+
5+
Относитесь с мудростью к тому, что вы пишете — важно знать как работает именно ваш код и как это соответствует приведённым в статье тезисам — и уже из этого вы сможете делать вывод, подходит ли вам тот или иной подход или нет. *Важно* знать как работает [прототипное наследование](#object.prototype), но это не так необходимо, если вы используете функциональный подход или пользуетесь какой-либо сторонней библиотекой. Важно помнить о том, что у вас недостаёт какого-либо конкретного знания и что пробел следует заполнить, но если вы не используете в работе эту часть, вы всё равно можете писать хороший код, если у вас есть талант.
6+

‎doc/ru/index.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,15 @@
6868
"articles": [
6969
"timeouts"
7070
]
71+
},
72+
{
73+
"title": "Пояснения",
74+
"dir": "appendix",
75+
"articles": [
76+
"fromtranslators"
77+
]
7178
}
79+
7280
]
7381
}
7482

‎doc/ru/intro/license.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## Лицензия
22

3-
JavaScript Гарден распространяется под [лицензией MIT][1] и располагается на [GitHub][2]. Если вы найдёте ошибку или опечатку, пожалуйста [сообщите нам о ней][3] или запросите права на загрузку репозитория. Кроме того, вы можете найти нас в [комнате JavaScript][4] среди чатов Stack Overflow.
3+
JavaScript Гарден распространяется под [лицензией MIT][1] и располагается на [GitHub][2]. Если вы найдёте ошибку или опечатку, пожалуйста [сообщите нам о ней][3] или запросите права на загрузку в репозиторий. Кроме того, вы можете найти нас в [комнате JavaScript][4] среди чатов Stack Overflow.
44

55
[1]: https://github.com/BonsaiDen/JavaScript-Garden/blob/next/LICENSE
66
[2]: https://github.com/BonsaiDen/JavaScript-Garden

‎doc/ru/object/general.md‎

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -74,23 +74,24 @@
7474
delete: 'Я тоже ключевое слово, так что я' // бросаю SyntaxError
7575
};
7676

77-
Свойства объектов могут записываться и напрямую символами и в виде строк. В соответствии с другим упущением в парсере JavaScript, этот код выбросит `SyntaxError` во всех версиях ранее ECMAScript 5.
77+
Свойства объектов могут записываться и явно символами и в виде закавыченных строк. В связи с другим упущением в парсере JavaScript, этот код выбросит `SyntaxError` во всех версиях ранее ECMAScript 5.
7878

79-
Источником ошибки является факт, что `delete` — это *ключевое слово* и поэтому его необходимо записывать как *строчный литерал* — ради уверенности в том, что оно будет корректно опознано более старыми движками JavaScript.
79+
Источником ошибки является факт, что `delete` — это *ключевое слово* и поэтому его необходимо записывать как *строчный литерал*: ради уверенности в том, что оно будет корректно опознано более старыми движками JavaScript.
8080

81-
И еще один пример в пользу строковой нотации, это относится к JSON:
81+
*От перев.:* И еще один пример в пользу строковой нотации, это относится к [JSON][2]:
8282

83-
// валидный JS и валидный JSON
83+
// валидный JavaScript и валидный JSON
8484
{
85-
"foo":"oof",
86-
"bar":"rab"
85+
'foo': 'oof',
86+
'bar': 'rab'
8787
}
8888

89-
// валидный JS и НЕ валидный JSON
89+
// валидный JavaScript и НЕ валидный JSON
9090
{
91-
foo:"oof",
92-
bar:"rab"
91+
foo: 'oof',
92+
bar: 'rab'
9393
}
9494

9595
[1]: http://ru.wikipedia.org/wiki/%D0%A5%D0%B5%D1%88-%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0
96+
[2]: http://ru.wikipedia.org/wiki/JSON
9697

‎doc/ru/object/hasownproperty.md‎

Lines changed: 16 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,41 @@
1-
## `hasOwnProperty`
1+
## Функция `hasOwnProperty`
22

3-
In order to check whether a object has a property defined on *itself* and **not**
4-
somewhere on its [prototype chain](#object.prototype), it is necessary to use the
5-
`hasOwnProperty` method which all objects inherit from `Object.prototype`.
3+
Если вам необходимо проверить, определено ли свойство у *самого объекта*, а **не** в его [цепочке прототипов](#object.prototype), вы можете использовать метод `hasOwnProperty`, который все объекты наследуют от `Object.prototype`.
64

7-
> **Note:** It is **not** enough to check whether a property is `undefined`. The
8-
> property might very well exist, but its value just happens to be set to
9-
> `undefined`.
5+
> **Note:** Для проверки наличия свойства **недостаточно** проверять, эквивалентно ли оно `undefined`. Свойство может вполне себе существовать, но при этом ему может быть присвоено значение `undefined`.
106
11-
`hasOwnProperty` is the only thing in JavaScript which deals with properties and
12-
does **not** traverse the prototype chain.
7+
`hasOwnProperty` — единственная функция в JavaScript, которая позволяет получить свойства объекта **без обращения** к цепочке его прототипов.
138

14-
// Poisoning Object.prototype
15-
Object.prototype.bar = 1;
9+
// испортим Object.prototype
10+
Object.prototype.bar = 1;
1611
var foo = {goo: undefined};
17-
12+
1813
foo.bar; // 1
1914
'bar' in foo; // true
2015

2116
foo.hasOwnProperty('bar'); // false
2217
foo.hasOwnProperty('goo'); // true
2318

24-
Only `hasOwnProperty` will give the correct and expected result, this is
25-
essential when iterating over the properties of any object. There is **no** other
26-
way to exclude properties that are not defined on the object *itself*, but
27-
somewhere on its prototype chain.
19+
Только используя hasOwnProperty можно гарантировать правильный результат при переборе свойств объекта. И **нет** иного способа для определения свойств, которые определены в *самом* объекте, а не где-то в цепочке прототипов.
2820

29-
### `hasOwnProperty` as a property
21+
### `hasOwnProperty` как свойство
3022

31-
JavaScript does **not** protect the property name `hasOwnProperty`; thus, if the
32-
possibility exists that an object might have a property with this name, it is
33-
necessary to use an *external* `hasOwnProperty` in order to get correct results.
23+
JavaScript **не** резервирует свойство с именем `hasOwnProperty`. Так что, если есть потенциальная возможность, что объект может содержать свойство с таким именем, требуется использовать *внешний* вариант функции `hasOwnProperty` чтобы получить корректные результаты.
3424

3525
var foo = {
3626
hasOwnProperty: function() {
3727
return false;
3828
},
39-
bar: 'Here be dragons'
29+
bar: 'Да прилетят драконы'
4030
};
4131

42-
foo.hasOwnProperty('bar'); // always returns false
32+
foo.hasOwnProperty('bar'); // всегда возвращает false
4333

44-
// Use another hasOwnProperty and call it with 'this' set to foo
34+
// Используем метод hasOwnProperty пустого объекта
35+
// и передаём foo в качестве this
4536
{}.hasOwnProperty.call(foo, 'bar'); // true
4637

47-
### In conclusion
38+
### Заключение
4839

49-
When checking for the existence of a property on a object, `hasOwnProperty` is
50-
the **only** method of doing so. It is also recommended to make `hasOwnProperty`
51-
part of **every** [`for in` loop](#object.forinloop), this will avoid errors from
52-
extended native [prototypes](#object.prototype).
40+
**Единственным** способом проверить существование свойства у объекта является использование метода `hasOwnProperty`. При этом, рекомендуется использовать этот метод в **каждом** [цикле `for in`](#object.forinloop) вашего проекта, чтобы избежать возможных ошибок с ошибочным заимствованием свойств из [прототипов](#object.prototype) родительских объектов. Также вы можете использовать конструкцию `{}.hasOwnProperty.call(...)` на случай, если кто-то вздумает расширить [прототипы](#object.prototype) встроенных объектов.
5341

‎doc/ru/object/prototype.md‎

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

33
В JavaScript отсутствует классическая модель наследования — вместо неё используется [*прототипная модель*][1].
44

5-
Хотя её часто расценивают как один из недостатков JavaScript, на самом деле прототипная модель наследования намного мощнее классической. К примеру, поверх неё предельно легко реализовать классическое наследование, а наоборот — тут уж придётся сильно потрудиться.
5+
Хотя её часто расценивают как один из недостатков JavaScript, на самом деле прототипная модель наследования намного мощнее классической. К примеру, поверх неё можно предельно легко реализовать классическое наследование, а попытки обойти его при этом могут создать только трудности.
66

77
Из-за того, что JavaScript — практически единственный широко используемый язык с прототипным наследованием, придётся потратить некоторое время на осознание различий между этими двумя моделями.
88

9-
Первое важное отличие заключается в том, что наследование в JavaScript производится с использованием так называемых *цепочек прототипов*.
9+
Первое важное отличие заключается в том, что наследование в JavaScript выполняется с использованием так называемых *цепочек прототипов*.
1010

11-
> **Замечание:** В результате выполнения конструкции `Bar.prototype = Foo.prototype` оба объекта будут делить друг с другом **один и тот же** прототип. Так что изменение прототипа одного из объектов повлечёт за собой изменение прототипа другого и наоборот — вряд ли это окажется тем, чего вы ожидали.
11+
> **Замечание:** В результате выполнения конструкции `Bar.prototype = Foo.prototype` оба объекта будут делить друг с другом **один и тот же** прототип. Так что изменение прототипа одного из объектов повлечёт за собой изменение прототипа другого и наоборот — вряд ли это окажется тем, что вы ожидали.
1212
1313
function Foo() {
1414
this.value = 42;
@@ -49,15 +49,15 @@
4949

5050
### Свойство `prototype`
5151

52-
То, что свойство `prototype` используется языком для построения цепочек прототипов, даёт нам возможность присвоить **любое** значение этому свойству. Однако, обычные примитивы будут просто-напросто игнорироваться при назначении в качестве прототипа.
52+
То, что свойство `prototype` используется языком для построения цепочек прототипов, даёт нам возможность присвоить **любое** значение этому свойству. Однако обычные примитивы будут просто-напросто игнорироваться, если назначать их в качестве прототипа.
5353

5454
function Foo() {}
5555
Foo.prototype = 1; // ничего не произойдёт
5656
Foo.prototype = {
5757
"foo":"bar"
5858
};
5959

60-
При этом присвоение объектов, как в примере выше, позволит динамически создавать цепочки прототипов.
60+
При этом присвоение объектов, как в примере выше, позволит вам динамически создавать цепочки прототипов.
6161

6262
### Производительность
6363

@@ -71,11 +71,11 @@
7171

7272
Подобная практика нарушает принцип *инкапсуляции*, и имеет соответствующее название — [monkey patching][2]. К сожалению, в основу многих широко распространенных фреймворков, например Prototype, положен принцип изменения базовых прототипов. Вам же стоит запомнить — от хорошей жизни прототипы встроенных объектов не меняют.
7373

74-
**Единственным** оправданием для расширения встроенных прототипов может быть только воссоздание возможностей более новых движков JavaScript, например функция [`Array.forEach`][4], которая появилась в версии 1.6.
74+
**Единственным** оправданием для расширения встроенных прототипов может быть только воссоздание возможностей более новых движков JavaScript, например функции [`Array.forEach`][4], которая появилась в версии 1.6.
7575

7676
### Заключение
7777

78-
Перед тем как разрабатывать сложные приложения на JavaScript, вы **должны** полностью понимать как работают прототипы, и как организовывать наследование на их основе. Так же, помните о зависимости между длиной цепочек прототипов и производительностью — разрывайте их при необходимости. Кроме того - **никогда** не расширяйте прототипы встроенных объектов (ну, если только для совместимости с новыми возможностями Javascript)
78+
Перед тем, как вы приступите к разработке сложных приложений на JavaScript, вы **должны** полностью осознать как работают прототипы, и как организовывать наследование на их основе. Также, помните о зависимости между длиной цепочек прототипов и производительностью — разрывайте их при необходимости. Кроме того - **никогда** не расширяйте прототипы встроенных объектов (ну, если только для совместимости с новыми возможностями Javascript).
7979

8080
[1]: http://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%BE%D1%82%D0%BE%D1%82%D0%B8%D0%BF%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5
8181
[2]: http://en.wikipedia.org/wiki/Monkey_patch

‎doc/ru/other/timeouts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -109,7 +109,7 @@
109109

110110
**Никогда** не используйте строки как параметры `setTimeout` или `setInterval`. Это явный признак **действительно** плохого кода, если вызываемой функции необходимо передавать аргументы. Лучше передавать *анонимную функцию*, которая самостоятельно будет отвечать за сам вызов.
111111

112-
Кроме того, избегайте использования `setInterval` в случаях, когда его планировщих может блокировать выполнение JavaScript.
112+
Кроме того, избегайте использования `setInterval` в случаях, когда его планировщик может блокировать выполнение JavaScript.
113113

114114
[1]: http://ru.wikipedia.org/wiki/Document_Object_Model
115115

0 commit comments

Comments
 (0)