Ревью 2

Author: xcurveballx

1-js/09-classes/07-mixins/article.md

@@ -4,7 +4,7 @@
 
 Иногда это может ограничивать нас. Например, у нас есть класс `StreetSweeper` и класс `Bicycle`, а мы хотим создать `StreetSweepingBicycle`.
 
-Или, говоря о программировании, у нас есть класс `Renderer`, который реализует шаблон, и класс `EventEmitter`, реализующий событие. Мы хотели бы объединить их функционал в классе `Page`, чтобы создать страницу, которая будет использовать шаблон и запускать событие.
+Или, говоря о программировании, у нас есть класс `User`, который реализует пользователей, и класс `EventEmitter`, реализующий события. Мы хотели бы добавить функционал класса `EventEmitter` к `User`, чтобы пользователи могли легко генерировать события.
 
 Для таких случаев существуют "примеси".
 
@@ -47,7 +47,7 @@ Object.assign(User.prototype, sayHiMixin);
 new User("Dude").sayHi(); // Hello Dude!
 ```
 
-Это не наследование, а просто копирование методов. Таким образом, класс `User` может расширять другие классы, но при этом также включать в себя примеси, "подмешивающие" другие методы.
+Это не наследование, а просто копирование методов. Таким образом, класс `User` может наследовать от другого класса, но при этом также включать в себя примеси, "подмешивающие" другие методы.
 
 Например:
 
@@ -61,7 +61,7 @@ Object.assign(User.prototype, sayHiMixin);
 
 Примеси могут наследовать друг другу.
 
-В примере ниже `sayHiMixin` наследуется от `sayMixin`:
+В примере ниже `sayHiMixin` наследует от `sayMixin`:
 
 ```js run
 let sayMixin = {
@@ -101,6 +101,7 @@ new User("Dude").sayHi(); // Hello Dude!
 
 ![](mixin-inheritance.png)
 
+Так как super ищет родительские методы в `[[HomeObject]].[[Prototype]]`, это означает `sayHiMixin.[[Prototype]]`, а не `User.[[Prototype]]`.
 Это связано с тем, что методы `sayHi` и `sayBye` были изначально созданы в объекте `sayHiMixin`. Так что их внутреннее свойство `[[HomeObject]]` ссылается на `sayHiMixin`, как показано на картинке выше.
 
 Вызов `super` ищет родительские методы в `[[HomeObject]].__proto__`, что означает `sayHiMixin.__proto__`, а не `User.__proto__`.
@@ -109,17 +110,17 @@ new User("Dude").sayHi(); // Hello Dude!
 
 А сейчас давайте создадим примесь, полезную в реальной жизни.
 
-Многие объекты в браузерной разработке (и не только) обладают важной способностью - они могут работать с событиями. События - это способ передачи информации всем, кто в ней заинтересован. Давайте создадим примесь, которая позволит легко добавлять функционал по работе с событиями любым классам/объектам.
+Многие объекты в браузерной разработке (и не только) обладают важной способностью - они могут генерировать события. События - отличный способ передачи информации всем, кто в ней заинтересован. Давайте создадим примесь, которая позволит легко добавлять функционал по работе с событиями любым классам/объектам.
 
-- Примесь добавит метод `.trigger(name, [data])` для генерации события. Аргумент `name` - это имя события, за которым следует опциональный аргумент `data`.
-- Также будет добавлен метод `.on(name, handler)`, который назначает обработчик для события с заданным именем. Обработчик будет вызван, когда событие произойдёт.
+- Примесь добавит метод `.trigger(name, [data])` для генерации события. Аргумент `name` - это имя события, за которым могут следовать другие аргументы с данными для события.
+- Также будет добавлен метод `.on(name, handler)`, который назначает обработчик для события с заданным именем. Обработчик будет вызван, когда произойдёт событие с указанным именем `name`, и получит данные из `.trigger`.
 - ...и метод `.off(name, handler)`, который удаляет обработчик указанного события.
 
-После того, как все методы примеси будут добавлены, объект `user` сможет сгенерировать событие `"login"` после входа пользователя в личный кабинет. Объект `calendar` тоже может рассчитывать на событие `"login"`, чтобы показывать зашедшему пользователю актуальный для него календарь.
+После того, как все методы примеси будут добавлены, объект `user` сможет сгенерировать событие `"login"` после входа пользователя в личный кабинет. А другой объект, к примеру, `calendar` сможет использовать это событие, чтобы показывать зашедшему пользователю актуальный для него календарь.
 
-Или `menu` может генерировать событие `"select"`, когда элемент меню выбран, а другие объекты могут захотеть получить эту информацию и тоже отреагировать на это событие.
+Или `menu` может генерировать событие `"select"`, когда элемент меню выбран, а другие объекты могут назначать обработчики, чтобы реагировать на это событие, и т.п.
 
-Рассмотрим это всё на примере:
+Вот код примеси:
 
 ```js run
 let eventMixin = {
@@ -170,7 +171,7 @@ let eventMixin = {
 
 2. `.off(eventName, handler)` -- убирает функцию из списка обработчиков.
 
-3. `.trigger(eventName, ...args)` -- генерирует событие: все назначенные обработчики из `_eventHandlers[eventName]` вызываются, и `args` передаётся им в качестве аргумента.
+3. `.trigger(eventName, ...args)` -- генерирует событие: все назначенные обработчики из `_eventHandlers[eventName]` вызываются, и `...args` передаются им в качестве аргументов.
 
 Использование:
 
@@ -181,23 +182,23 @@ class Menu {
     this.trigger("select", value);
   }
 }
-// Добавим примесь
+// Добавим примесь с методами для событий
 Object.assign(Menu.prototype, eventMixin);
 
 let menu = new Menu();
 
-// Вызовем обработчик на событие "select":
+// Добавить обработчик, который будет вызван при событии "select":
 *!*
 menu.on("select", value => alert(`Выбранное значение: ${value}`));
 */!*
 
-// Запустили событие => будет показано "Выбранное значение: 123"
-menu.choose("123"); // выбранное значение
+// Генерирует событие => обработчик выше запускается и выводит:
+menu.choose("123"); // Выбранное значение: 123
 ```
 
-Если у нас есть код, заинтересованный в событии "select", то он может подписаться на него с помощью `menu.on(...)`.
+Теперь если у нас есть код, заинтересованный в событии `"select"`, то он может слушать его с помощью `menu.on(...)`.
 
-И `eventMixin` позволяет легко добавить такое поведение в любой класс без вмешательства в цепочку наследования.
+А `eventMixin` позволяет легко добавить такое поведение в любой класс без вмешательства в цепочку наследования.
 
 ## Итого
 
@@ -207,4 +208,4 @@ menu.choose("123"); // выбранное значение
 
 Мы можем использовать примеси для расширения функционала классов, например, для обработки событий, как мы сделали это выше.
 
-С примесями могут возникнуть проблемы, если они перезаписывают нативные методы класса. Стоит помнить об этом и быть внимательнее при выборе имён методов для примеси, чтобы избежать конфликтов и ошибок.
+С примесями могут возникнуть проблемы, если они перезаписывают существующие методы класса. Стоит помнить об этом и быть внимательнее при выборе имён для методов примеси, чтобы избежать конфликтов.