up

Author: iliakan

1-js/03-code-quality/05-testing/3-pow-test-wrong/solution.md

@@ -1,8 +1,12 @@
-Этот тест демонстрирует один из соблазнов, которые ожидают начинающего автора тестов.
+The test demonstrates one of temptations a developer meets when writing tests.
 
-Вместо того, чтобы написать три различных теста, он изложил их в виде одного потока вычислений, с несколькими `assert`.
+What we have here is actually 3 tests, but layed out as a single function with 3 asserts.
 
-Иногда так написать легче и проще, однако при ошибке в тесте гораздо менее очевидно, что же пошло не так.
+Sometimes it's easier to write this way, but if an error occurs, it's much less obvious what went wrong.
+
+If an error happens inside a complex execution flow, then we'll have to figure out what was the data at that point.
+
+TODO
 
 Если в сложном тесте произошла ошибка где-то посередине потока вычислений, то придётся выяснять, какие конкретно были входные и выходные данные на этот момент, то есть по сути -- отлаживать код самого теста.
 

1-js/03-code-quality/05-testing/3-pow-test-wrong/task.md

@@ -2,23 +2,23 @@ importance: 5
 
 ---
 
-# Что не так в тесте?
+# What's wrong in the test?
 
-Что не так в этом тесте функции `pow`?
+What's wrong in the test of `pow` below?
 
 ```js
-it("Возводит x в степень n", function() {
-  var x = 5;
+it("Raises x to the power n", function() {
+  let x = 5;
 
-  var result = x;
+  let result = x;
   assert.equal(pow(x, 1), result);
 
-  var result *= x;
+  result *= x;
   assert.equal(pow(x, 2), result);
 
-  var result *= x;
+  result *= x;
   assert.equal(pow(x, 3), result);
 });
 ```
 
-P.S. Синтаксически он верен и работает, но спроектирован неправильно.
+P.S. Syntactically it's correct and passes.

1-js/04-object-basics/06-constructor-new/1-two-functions-one-object/solution.md

@@ -1,18 +1,14 @@
-Да, возможны.
+Yes, it's possible.
 
-Они должны возвращать одинаковый объект. При этом если функция возвращает объект, то `this` не используется.
+If a function returns an object then `new` returns it instead of `this`.
 
-Например, они могут вернуть один и тот же объект `obj`, определённый снаружи:
+So thay can, for instance, return the same externally defined object `obj`:
 
 ```js run no-beautify
-var obj = {};
+let obj = {};
 
 function A() { return obj; }
 function B() { return obj; }
 
-var a = new A;
-var b = new B;
-
-alert( a == b ); // true
+alert( new A() == new B() ); // true
 ```
-

1-js/04-object-basics/06-constructor-new/1-two-functions-one-object/task.md

@@ -2,9 +2,9 @@ importance: 2
 
 ---
 
-# Две функции один объект
+# Two functions -- one object
 
-Возможны ли такие функции `A` и `B` в примере ниже, что соответствующие объекты `a,b` равны (см. код ниже)?
+Is it possible to create functions `A` and `B` such as `new A()==new B()`?
 
 ```js no-beautify
 function A() { ... }
@@ -16,4 +16,4 @@ var b = new B;
 alert( a == b ); // true
 ```
 
-Если да -- приведите пример кода с такими функциями.
+If it is, then provide an example of their code.

1-js/04-object-basics/06-constructor-new/2-calculator-constructor/_js.view/test.js

@@ -1,25 +1,25 @@
-sinon.stub(window, "prompt")
-
-prompt.onCall(0).returns("2");
-prompt.onCall(1).returns("3");
 
 describe("calculator", function() {
-  var calculator;
+  let calculator;
   before(function() {
+    sinon.stub(window, "prompt")
+
+    prompt.onCall(0).returns("2");
+    prompt.onCall(1).returns("3");
+
     calculator = new Calculator();
     calculator.read();
   });
 
-  it("при вводе 2 и 3 сумма равна 5", function() {
+  it("when 2 and 3 are entered, the sum is 5", function() {
     assert.equal(calculator.sum(), 5);
   });
 
-  it("при вводе 2 и 3 произведение равно 6", function() {
+  it("when 2 and 3 are entered, the product is 6", function() {
     assert.equal(calculator.mul(), 6);
   });
 
+  after(function() {
+    prompt.restore();
+  });
 });
-
-after(function() {
-  prompt.restore();
-});

1-js/04-object-basics/06-constructor-new/2-calculator-constructor/solution.md

@@ -17,10 +17,9 @@ function Calculator() {
   };
 }
 
-var calculator = new Calculator();
+let calculator = new Calculator();
 calculator.read();
 
-alert( "Сумма=" + calculator.sum() );
-alert( "Произведение=" + calculator.mul() );
+alert( "Sum=" + calculator.sum() );
+alert( "Mul=" + calculator.mul() );
 ```
-

1-js/04-object-basics/06-constructor-new/2-calculator-constructor/task.md

@@ -2,23 +2,22 @@ importance: 5
 
 ---
 
-# Создать Calculator при помощи конструктора
+# Create new Calculator
 
-Напишите *функцию-конструктор* `Calculator`, которая создает объект с тремя методами:
+Create a constructor function `Calculator` that creates objects with 3 methods:
 
-- Метод `read()` запрашивает два значения при помощи `prompt` и запоминает их в свойствах объекта.
-- Метод `sum()` возвращает сумму запомненных свойств.
-- Метод `mul()` возвращает произведение запомненных свойств.
+- `read()` asks for two values using `prompt` and remembers them in object properties.
+- `sum()` returns the sum of these properties.
+- `mul()` returns the multiplication product of these properties.
 
-Пример использования:
+For instance:
 
 ```js
-var calculator = new Calculator();
+let calculator = new Calculator();
 calculator.read();
 
-alert( "Сумма=" + calculator.sum() );
-alert( "Произведение=" + calculator.mul() );
+alert( "Sum=" + calculator.sum() );
+alert( "Mul=" + calculator.mul() );
 ```
 
 [demo]
-

1-js/04-object-basics/06-constructor-new/3-accumulator/_js.view/solution.js

@@ -2,7 +2,7 @@ function Accumulator(startingValue) {
   this.value = startingValue;
 
   this.read = function() {
-    this.value += +prompt('Сколько добавлять будем?', 0);
+    this.value += +prompt('How much to add?', 0);
   };
 
-}
+}

1-js/04-object-basics/06-constructor-new/3-accumulator/_js.view/test.js

@@ -1,8 +1,4 @@
-describe("Accumulator(1)", function() {
-  var accumulator;
-  before(function() {
-    accumulator = new Accumulator(1);
-  });
+describe("Accumulator", function() {
 
   beforeEach(function() {
     sinon.stub(window, "prompt")
@@ -12,26 +8,23 @@ describe("Accumulator(1)", function() {
     prompt.restore();
   });
 
-  it("начальное значение 1", function() {
+  it("initial value is the argument of the constructor", function() {
+    let accumulator = new Accumulator(1);
+
     assert.equal(accumulator.value, 1);
   });
 
-  it("после ввода 0 значение 1", function() {
+  it("after reading 0, the value is 1", function() {
+    let accumulator = new Accumulator(1);
     prompt.returns("0");
     accumulator.read();
     assert.equal(accumulator.value, 1);
   });
 
-  it("после ввода 1 значение 2", function() {
+  it("after reading 1, the value is 2", function() {
+    let accumulator = new Accumulator(1);
     prompt.returns("1");
     accumulator.read();
     assert.equal(accumulator.value, 2);
   });
-
-  it("после ввода 2 значение 4", function() {
-    prompt.returns("2");
-    accumulator.read();
-    assert.equal(accumulator.value, 4);
-  });
-
-});
+});

1-js/04-object-basics/06-constructor-new/3-accumulator/solution.md

@@ -5,14 +5,13 @@ function Accumulator(startingValue) {
   this.value = startingValue;
 
   this.read = function() {
-    this.value += +prompt('Сколько добавлять будем?', 0);
+    this.value += +prompt('How much to add?', 0);
   };
 
 }
 
-var accumulator = new Accumulator(1);
+let accumulator = new Accumulator(1);
 accumulator.read();
 accumulator.read();
-alert( accumulator.value );
+alert(accumulator.value);
 ```
-

1-js/04-object-basics/06-constructor-new/3-accumulator/task.md

@@ -2,26 +2,24 @@ importance: 5
 
 ---
 
-# Создать Accumulator при помощи конструктора
+# Create new Accumulator
 
-Напишите *функцию-конструктор* `Accumulator(startingValue)`.
-Объекты, которые она создает, должны хранить текущую сумму и прибавлять к ней то, что вводит посетитель.
+Create a constructor function `Accumulator(startingValue)`.
 
-Более формально, объект должен:
+Object that it creates should:
 
-- Хранить текущее значение в своём свойстве `value`. Начальное значение свойства `value` ставится конструктором равным `startingValue`.
-- Метод `read()` вызывает `prompt`, принимает число и прибавляет его к свойству `value`.
+- Store the "current value" in the property `value`. The starting value is set to the argument of the constructor `startingValue`.
+- The `read()` method should use `prompt` to read a new number and add it to `value`.
 
-Таким образом, свойство `value` является текущей суммой всего, что ввел посетитель при вызовах метода `read()`, с учетом начального значения `startingValue`.
+In other words, the `value` property is the sum of all user-entered values with the initial value  `startingValue`.
 
-Ниже вы можете посмотреть работу кода:
+Here's the demo of the code:
 
 ```js
-var accumulator = new Accumulator(1); // начальное значение 1
-accumulator.read(); // прибавит ввод prompt к текущему значению
-accumulator.read(); // прибавит ввод prompt к текущему значению
-alert( accumulator.value ); // выведет текущее значение
+let accumulator = new Accumulator(1); // initial value 1
+accumulator.read(); // adds the user-entered value
+accumulator.read(); // adds the user-entered value
+alert(accumulator.value); // shows the sum of these values
 ```
 
 [demo]
-

1-js/04-object-basics/06-constructor-new/4-calculator-extendable/_js.view/solution.js

@@ -1,17 +1,13 @@
 function Calculator() {
 
-  var methods = {
-    "-": function(a, b) {
-      return a - b;
-    },
-    "+": function(a, b) {
-      return a + b;
-    }
+  let methods = {
+    "-": (a, b) => a - b,
+    "+": (a, b) => a + b
   };
 
   this.calculate = function(str) {
 
-    var split = str.split(' '),
+    let split = str.split(' '),
       a = +split[0],
       op = split[1],
       b = +split[2]

1-js/04-object-basics/06-constructor-new/4-calculator-extendable/_js.view/test.js

@@ -1,26 +1,25 @@
-var calculator;
-before(function() {
-  calculator = new Calculator;
-});
+describe("Calculator", function() {
+  let calculator;
 
-it("calculate(12 + 34) = 46", function() {
-  assert.equal(calculator.calculate("12 + 34"), 46);
-});
+  before(function() {
+    calculator = new Calculator;
+  });
 
-it("calculate(34 - 12) = 22", function() {
-  assert.equal(calculator.calculate("34 - 12"), 22);
-});
+  it("calculate(12 + 34) = 46", function() {
+    assert.equal(calculator.calculate("12 + 34"), 46);
+  });
 
-it("добавили умножение: calculate(2 * 3) = 6", function() {
-  calculator.addMethod("*", function(a, b) {
-    return a * b;
+  it("calculate(34 - 12) = 22", function() {
+    assert.equal(calculator.calculate("34 - 12"), 22);
+  });
+
+  it("add multiplication: calculate(2 * 3) = 6", function() {
+    calculator.addMethod("*", (a, b) => a * b);
+    assert.equal(calculator.calculate("2 * 3"), 6);
   });
-  assert.equal(calculator.calculate("2 * 3"), 6);
-});
 
-it("добавили возведение в степень: calculate(2 ** 3) = 8", function() {
-  calculator.addMethod("**", function(a, b) {
-    return Math.pow(a, b);
+  it("add power: calculate(2 ** 3) = 8", function() {
+    calculator.addMethod("**", (a, b) => a ** b);
+    assert.equal(calculator.calculate("2 ** 3"), 8);
   });
-  assert.equal(calculator.calculate("2 ** 3"), 8);
-});
+});