03-debounce

Author: mykhaliuk

1-js/06-advanced-functions/09-call-apply-decorators/03-debounce/_js.view/test.js

@@ -7,7 +7,7 @@ describe("debounce", function() {
     this.clock.restore();
   });
 
-  it("calls the function at maximum once in ms milliseconds", function() {
+  it("вызывает функцию максимум один раз в мс", function() {
     let log = '';
 
     function f(a) {
@@ -16,18 +16,18 @@ describe("debounce", function() {
 
     f = debounce(f, 1000);
 
-    f(1); // runs at once
-    f(2); // ignored
+    f(1); // вызвана
+    f(2); // проигнорирована
 
-    setTimeout(() => f(3), 100);  // ignored (too early)
-    setTimeout(() => f(4), 1100); // runs (1000 ms passed)
-    setTimeout(() => f(5), 1500); // ignored (less than 1000 ms from the last run)
+    setTimeout(() => f(3), 100);  // проигнорирована (слишком рано)
+    setTimeout(() => f(4), 1100); // вызвана (1000 мс истекли)
+    setTimeout(() => f(5), 1500); // проигнорирована (менее 1000 мс с последнего вызова)
 
     this.clock.tick(5000);
     assert.equal(log, "14");
   });
 
-  it("keeps the context of the call", function() {
+  it("сохраняет контекст вызова", function() {
     let obj = {
       f() {
         assert.equal(this, obj);
@@ -38,4 +38,4 @@ describe("debounce", function() {
     obj.f("test");
   });
 
-});
+});

1-js/06-advanced-functions/09-call-apply-decorators/03-debounce/solution.md

@@ -16,13 +16,12 @@ function debounce(f, ms) {
 }
 ```
 
-A call to `debounce` returns a wrapper. There may be two states:
+Вызов `debounce` возвращает обёртку. Возможны два состояния:
+- `isCooldown = false` -- готова к выполнению.
+- `isCooldown = true` -- ожидание окончания тайм-аута.
 
-- `isCooldown = false` -- ready to run.
-- `isCooldown = true` -- waiting for the timeout.
+В первом вызове `isCoolDown` является ложным, поэтому вызов продолжается, и состояние изменяется на `true`.
 
-In the first call `isCooldown` is falsy, so the call proceeds, and the state changes to `true`.
+Пока `isCoolDown` имеет значение true, все остальные вызовы игнорируются.
 
-While `isCooldown` is true, all other calls are ignored.
-
-Then `setTimeout` reverts it to `false` after the given delay.
+Затем `setTimeout` устанавливает в него значение `false` после заданной задержки.

1-js/06-advanced-functions/09-call-apply-decorators/03-debounce/task.md

@@ -1,24 +1,23 @@
-importance: 5
+важность: 5
 
 ---
 
-# Debounce decorator
+# Отклоняющий декоратор
 
-The result of `debounce(f, ms)` decorator should be a wrapper that passes the call to `f` at maximum once per `ms` milliseconds.
+Результатом декоратора `debounce(f, ms)` должна быть обёртка, которая передает вызов `f` не более одного раза в `ms` миллисекунд.
+Другими словами, когда мы вызываем «отклоненную» функцию, это гарантирует, что все остальные вызовы будут игнорироваться в течении `ms`.
 
-In other words, when we call a "debounced" function, it guarantees that all other future in the closest `ms` milliseconds will be ignored.
-
-For instance:
+Например:
 
 ```js no-beautify
 let f = debounce(alert, 1000);
 
-f(1); // runs immediately
-f(2); // ignored
+f(1); // выполняется немедленно
+f(2); // проигнорирован
 
-setTimeout( () => f(3), 100); // ignored ( only 100 ms passed )
-setTimeout( () => f(4), 1100); // runs
-setTimeout( () => f(5), 1500); // ignored (less than 1000 ms from the last run)
+setTimeout( () => f(3), 100); // проигнорирован ( прошло только 100 мс )
+setTimeout( () => f(4), 1100); // выполняется
+setTimeout( () => f(5), 1500); // проигнорирован ( прошло только 100 мс от последнего вызова)
 ```
 
-In practice `debounce` is useful for functions that retrieve/update something when we know that nothing new can be done in such a short period of time, so it's better not to waste resources.
+На практике `debounce` полезен для функций, которые извлекают/обновляют что-то и мы знаем, что ничего нового нельзя сделать за такой короткий период времени, поэтому лучше не тратить ресурсы.