review 1

Author: xcurveballx

1-js/99-js-misc/01-proxy/article.md

@@ -1,7 +1,7 @@
 
 # Proxy и Reflect
 
-Объект *proxy* служит обёрткой для другого объекта, а также перехватывает и (опционально) обрабатывает разные действия, например чтение/запись свойств и другие, производимые с оригинальным объектом.
+Объект *прокси* "оборачивается" вокруг другого объекта и может перехватывать (и, при желании, самостоятельно обрабатывать) разные действия с ним, например чтение/запись свойств и другие.
 
 Прокси используются во многих библиотеках и некоторых браузерных фреймворках. В этой главе мы увидим много случаев применения прокси в решении реальных задач.
 
@@ -14,7 +14,7 @@ let proxy = new Proxy(target, handler)
 - `target` -- это объект, который обёртывается, может быть чем угодно, включая функции.
 - `handler` -- объект с "ловушками" ("traps"): методами, которые перехватывают разные операции, например `get` при чтении свойства, `set` при записи свойства и так далее.
 
-Если в `handler` объекта `proxy` имеется соответствующая "ловушка", то она срабатывает, и прокси имеет возможность как-то среагировать, иначе же действовать будет уже оригинальный объект из `target`.
+При операциях над `proxy`, если в `handler` имеется соответствующая "ловушка", то она срабатывает, и прокси имеет возможность как-то среагировать, иначе действие будет совершено над оригинальным объектом `target`.
 
 В качестве примера давайте для начала создадим прокси без всяких ловушек:
 
@@ -30,7 +30,7 @@ alert(proxy.test); // 5, мы также можем прочитать его и
 for(let key in proxy) alert(key); // test, итерация работает (3)
 ```
 
-Так как нет ловушек, то все операции на `proxy` в итоге применяются к оригинальному объекту `target`.
+Так как нет ловушек, то все операции на `proxy` применяются к оригинальному объекту `target`.
 
 1. Запись свойства `proxy.test=` устанавливает значение на `target`.
 2. Чтение свойства `proxy.test` возвращает значение из `target`.
@@ -42,13 +42,13 @@ for(let key in proxy) alert(key); // test, итерация работает (3)
 
 Прокси -- это особенный объект, у него нет собственных свойств. С пустым `handler` он просто перенаправляет все операции на `target`.
 
-Если мы хотим придать ему какую-то магическую силу, то следует добавить ловушки.
+Чтобы активировать его возможности, добавим ловушки.
 
 Вот список внутренних методов объектов из [спецификации Proxy](https://tc39.es/ecma262/#sec-proxy-object-internal-methods-and-internal-slots). Прокси может перехватывать вызов любого из них, нужно только добавить соответствующий обработчик в `handler`.
 
 В таблице ниже:
-- **Внутренний метод** -- название операции над объектом, определённое в спецификации. Например, `[[Get]]` -- это имя внутреннего метода для чтения свойства объекта. В спецификации описывается, как это должно быть реализовано, до мельчайших низкоуровневых подробностей.
-- **Ловушка** -- это имя метода, который мы можем добавить в параметр `handler` при создании прокси. Этот метод будет действовать как ловушка, перехватывая операции над объектом и позволяя совершать над ним какие-то дополнительные действия.
+- **Внутренний метод** -- название операции над объектом, определённое в спецификации. Например, `[[Get]]` -- это имя внутреннего (используемого только внутри спецификации) метода для чтения свойства объекта. В спецификации описывается, как это должно быть реализовано, до мельчайших низкоуровневых подробностей.
+- **Ловушка** -- это имя метода, который мы можем добавить в параметр `handler` при создании прокси. Этот метод будет действовать как ловушка, перехватывающая данную операцию и позволяющая совершать какие-то дополнительные действия.
 
 
 | Внутренний метод | Ловушка | Срабатывает при... |
@@ -68,15 +68,15 @@ for(let key in proxy) alert(key); // test, итерация работает (3)
 | `[[OwnPropertyKeys]]` | `ownKeys` | [Object.keys](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/keys), [Object.getOwnPropertyNames](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames), [Object.getOwnPropertySymbols](https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertySymbols), итерация по ключам |
 
 ```warn header="Инварианты"
-JavaScript предполагает, что при реализации внутренних методов и ловушек в коде будут выполнены определённые условия -- инварианты.
+JavaScript налагает некоторые условия - инварианты на реализацию внутренних методов и ловушек.
 
 Большинство из них касаются возвращаемых значений:
 - `[[Set]]` должен возвращать `true`, если значение было успешно записано, иначе `false`.
 - `[[Delete]]` должен возвращать `true`, если значение было успешно удалено, иначе `false`.
-- ...и так далее, мы ещё столкнёмся с этим в примерах ниже.
+- ...и так далее, мы увидим больше в примерах ниже.
 
-Но есть и другие условия:
-- `[[GetPrototypeOf]]`, применённый к прокси, должен возвращать то же значение, что и метод `[[GetPrototypeOf]]`, применённый к оригинальному объекту.
+Есть и другие инварианты, например:
+- метод `[[GetPrototypeOf]]`, применённый к прокси, должен возвращать то же значение, что и метод `[[GetPrototypeOf]]`, применённый к оригинальному объекту.
 
 Другими словами, чтение прототипа объекта `proxy` всегда должно возвращать прототип оригинального объекта. Ловушка `getPrototypeOf` может перехватывать эту операцию, но в любом случае должна выполнять указанное условие, а не делать что-то сумасшедшее.