From d527d47d926b8ff165c47b8be7b95ce6c9265209 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Sat, 20 Mar 2021 13:22:35 +0300 Subject: Unify Russian translation for callback word (#226) * Unify Russian translation for callback word * Apply suggestions from code review Co-authored-by: Sasha Sushko * Fixes Co-authored-by: Sasha Sushko --- files/ru/web/javascript/reference/errors/not_a_function/index.html | 4 ++-- .../errors/reduce_of_empty_array_with_no_initial_value/index.html | 2 +- .../reference/errors/unnamed_function_statement/index.html | 2 +- .../ru/web/javascript/reference/global_objects/array/map/index.html | 2 +- .../web/javascript/reference/global_objects/array/reduce/index.html | 4 ++-- .../reference/global_objects/array/reduceright/index.html | 6 +++--- .../javascript/reference/global_objects/function/bind/index.html | 4 ++-- files/ru/web/javascript/reference/global_objects/map/index.html | 2 +- .../javascript/reference/global_objects/object/create/index.html | 2 +- files/ru/web/javascript/reference/operators/function/index.html | 2 +- .../web/javascript/reference/operators/optional_chaining/index.html | 4 ++-- .../web/javascript/reference/statements/async_function/index.html | 2 +- 12 files changed, 18 insertions(+), 18 deletions(-) (limited to 'files/ru/web/javascript/reference') diff --git a/files/ru/web/javascript/reference/errors/not_a_function/index.html b/files/ru/web/javascript/reference/errors/not_a_function/index.html index 400db48a69..1f4c9bc29c 100644 --- a/files/ru/web/javascript/reference/errors/not_a_function/index.html +++ b/files/ru/web/javascript/reference/errors/not_a_function/index.html @@ -24,7 +24,7 @@ translation_of: Web/JavaScript/Reference/Errors/Not_a_function

Возможно, есть ошибка в имени функции? Возможно, объект, метод которого вы вызываете, не содержит в себе этой функции? Для примера, JavaScript объекты не имеют map функции, а JavaScript Array - имеют.

-

Есть множество функций нуждающихся в функциях обратного вызова. Вы должны будете предоставить функцию обратного вызова для того, чтобы эти методы работы правильно:

+

Есть множество функций, нуждающихся в колбэк-функциях. Вы должны будете предоставить колбэк-функцию для того, чтобы эти методы работы правильно:

  • Когда работаете с  {{jsxref("Array")}} или {{jsxref("TypedArray")}} объектами: @@ -56,7 +56,7 @@ translation_of: Web/JavaScript/Reference/Errors/Not_a_function

    Функция вызвана с неверным объектом

    -

    Для некоторых методов, вы должны предоставить функцию обратного вызова и она будет работать только на корректных объектах.  В этом примере используется {{jsxref("Array.prototype.map()")}}, в котором {{jsxref("Array")}} будет работать только с массивами.

    +

    Для некоторых методов вы должны предоставить колбэк-функцию, и она будет работать только на корректных объектах.  В этом примере используется {{jsxref("Array.prototype.map()")}}, в котором {{jsxref("Array")}} будет работать только с массивами.

    var obj = { a: 13, b: 37, c: 42 };
 
diff --git a/files/ru/web/javascript/reference/errors/reduce_of_empty_array_with_no_initial_value/index.html b/files/ru/web/javascript/reference/errors/reduce_of_empty_array_with_no_initial_value/index.html
index 012d203930..b116ae0666 100644
--- a/files/ru/web/javascript/reference/errors/reduce_of_empty_array_with_no_initial_value/index.html
+++ b/files/ru/web/javascript/reference/errors/reduce_of_empty_array_with_no_initial_value/index.html
@@ -25,7 +25,7 @@ translation_of: Web/JavaScript/Reference/Errors/Reduce_of_empty_array_with_no_in
  
  • {{jsxref("TypedArray.prototype.reduce()")}},  {{jsxref("TypedArray.prototype.reduceRight()")}}).
    •
-

Эти функции дополнительно принимают значение initialValue (которое будет использоваться в качестве первого аргумента для первого вызова обратного вызова). Однако если начальное значение не указано, будет использоваться первый элемент {{jsxref("Array")}} или {{jsxref("TypedArray")}} в качестве начального значения. Эта ошибка возникает, когда предоставляется пустой массив, так как в этом случае не может быть возвращено начальное значение.

+

Эти функции дополнительно принимают значение initialValue (которое будет использоваться в качестве первого аргумента для первого вызова колбэка). Однако если начальное значение не указано, будет использоваться первый элемент {{jsxref("Array")}} или {{jsxref("TypedArray")}} в качестве начального значения. Эта ошибка возникает, когда предоставляется пустой массив, так как в этом случае не может быть возвращено начальное значение.

Примеры

diff --git a/files/ru/web/javascript/reference/errors/unnamed_function_statement/index.html b/files/ru/web/javascript/reference/errors/unnamed_function_statement/index.html index 0554d0d93c..0c950c014e 100644 --- a/files/ru/web/javascript/reference/errors/unnamed_function_statement/index.html +++ b/files/ru/web/javascript/reference/errors/unnamed_function_statement/index.html @@ -76,7 +76,7 @@ SyntaxError: непредвиденный токен ( [Chrome]

Синтаксис вызова

-

Кроме того, проверьте синтаксис при использовании обратных вызовов. Скобки и запятые может получить трудно легко.

+

Кроме того, внимательно следите за синтаксисом при использовании колбэков. Очень легко забыть скобку или запятую.

promise.then(
   function() {
diff --git a/files/ru/web/javascript/reference/global_objects/array/map/index.html b/files/ru/web/javascript/reference/global_objects/array/map/index.html
index cf20b40d62..89a4c3362c 100644
--- a/files/ru/web/javascript/reference/global_objects/array/map/index.html
+++ b/files/ru/web/javascript/reference/global_objects/array/map/index.html
@@ -123,7 +123,7 @@ var values = [].map.call(elems, function(obj) {
 
 
(навеяно этой записью в блоге)

 
-
Распространённой практикой является использование функции обратного вызова с одним аргументом (элемент, над которым производится операция). Некоторые функции также широко используется с одним аргументом, хотя они принимают дополнительные необязательные аргументы. Эти привычки могут привести к неожиданному поведению программы.

+
Распространённой практикой является использование колбэк-функции с одним аргументом (элемент, над которым производится операция). Некоторые функции также широко используется с одним аргументом, хотя они принимают дополнительные необязательные аргументы. Эти привычки могут привести к неожиданному поведению программы.

 
 
// Рассмотрим пример:
 ['1', '2', '3'].map(parseInt);
diff --git a/files/ru/web/javascript/reference/global_objects/array/reduce/index.html b/files/ru/web/javascript/reference/global_objects/array/reduce/index.html
index ef2e7f44b9..b135b336ee 100644
--- a/files/ru/web/javascript/reference/global_objects/array/reduce/index.html
+++ b/files/ru/web/javascript/reference/global_objects/array/reduce/index.html
@@ -60,7 +60,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/Reduce
 });
 

 
-
Функция обратного вызова будет вызвана четыре раза, аргументы и возвращаемое значение при каждом вызове будут следующими:

+
Колбэк-функция будет вызвана четыре раза, аргументы и возвращаемое значение при каждом вызове будут следующими:

 
 
@@ -109,7 +109,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/Reduce
  

  
 

 
-
Значение, возвращённое методом reduce() будет равным последнему результату выполнения функции обратного вызова (10).

+
Значение, возвращённое методом reduce() будет равным последнему результату выполнения колбэк-функции — 10.

 
 
Если же вы зададите начальное значение initialValue, результат будет выглядеть так:

 
diff --git a/files/ru/web/javascript/reference/global_objects/array/reduceright/index.html b/files/ru/web/javascript/reference/global_objects/array/reduceright/index.html
index ae8a68cef1..69ec3d6678 100644
--- a/files/ru/web/javascript/reference/global_objects/array/reduceright/index.html
+++ b/files/ru/web/javascript/reference/global_objects/array/reduceright/index.html
@@ -41,7 +41,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/ReduceRight
 
 
Описание

 
Метод reduceRight() выполняет функцию callback один раз для каждого элемента, присутствующего в массиве, за исключением пустот, принимая четыре аргумента: начальное значение (или значение от предыдущего вызова callback), значение текущего элемента, текущий индекс и массив, по которому происходит итерация.

-
Вызов функции обратного вызова callback будет выглядеть так:

+
Вызов колбэк-функции callback будет выглядеть так:

 
array.reduceRight(function(previousValue, currentValue, index, array) {
   // ...
 });
@@ -53,7 +53,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/ReduceRight
   return previousValue + currentValue;
 });
 

-
Функция обратного вызова будет вызвана четыре раза, аргументы и возвращаемое значение при каждом вызове будут следующими:

+
Колбэк-функция будет вызвана четыре раза, аргументы и возвращаемое значение при каждом вызове будут следующими:

 
@@ -100,7 +100,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Array/ReduceRight
   

  
   

  
 

-
Значение, возвращённое методом reduceRight() будет равным последнему результату выполнения функции обратного вызова (10).

+
Значение, возвращённое методом reduceRight() будет равным последнему результату выполнения колбэк-функции — 10.

 
Если же вы зададите начальное значение initialValue, результат будет выглядеть так:

 
[0, 1, 2, 3, 4].reduceRight(function(previousValue, currentValue, index, array) {
   return previousValue + currentValue;
diff --git a/files/ru/web/javascript/reference/global_objects/function/bind/index.html b/files/ru/web/javascript/reference/global_objects/function/bind/index.html
index 6cd8230241..d153dc9e5c 100644
--- a/files/ru/web/javascript/reference/global_objects/function/bind/index.html
+++ b/files/ru/web/javascript/reference/global_objects/function/bind/index.html
@@ -57,7 +57,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Function/bind
 
 
Пример: создание привязанной функции

 
-
Простейшим способом использования bind() является создание функции, которая, вне зависимости от способа её вызова, вызывается с определённым значением this. Обычным заблуждением для новичков в JavaScript является извлечение метода из объекта с целью его дальнейшего вызова в качестве функции и ожидание того, что он будет использовать оригинальный объект в качестве своего значения this (например, такое может случиться при использовании метода как функции обратного вызова). Однако, без специальной обработки, оригинальный объект зачастую теряется. Создание привязанной функции из функции, использующей оригинальный объект, изящно решает эту проблему:

+
Простейшим способом использования bind() является создание функции, которая, вне зависимости от способа её вызова, вызывается с определённым значением this. Обычным заблуждением для новичков в JavaScript является извлечение метода из объекта с целью его дальнейшего вызова в качестве функции и ожидание того, что он будет использовать оригинальный объект в качестве своего значения this (например, такое может случиться при использовании метода как колбэк-функции). Однако, без специальной обработки, оригинальный объект зачастую теряется. Создание привязанной функции из функции, использующей оригинальный объект, изящно решает эту проблему:

 
 
this.x = 9;
 var module = {
@@ -94,7 +94,7 @@ var list3 = leadingThirtysevenList(1, 2, 3); // [37, 1, 2, 3]
 
 
Пример: с setTimeout

 
-
По умолчанию, внутри {{domxref("window.setTimeout()")}} контекст this устанавливается в объект {{domxref("window")}} (или global). При работе с методами класса, требующими this для ссылки на экземпляры класса, вы можете явно привязать this к функции обратного вызова для сохранения экземпляра.

+
По умолчанию, внутри {{domxref("window.setTimeout()")}} контекст this устанавливается в объект {{domxref("window")}} (или global). При работе с методами класса, требующими this для ссылки на экземпляры класса, вы можете явно привязать this к колбэк-функции для сохранения экземпляра.

 
 
function LateBloomer() {
   this.petalCount = Math.ceil(Math.random() * 12) + 1;
diff --git a/files/ru/web/javascript/reference/global_objects/map/index.html b/files/ru/web/javascript/reference/global_objects/map/index.html
index 9d0fac93a8..4548a2f79a 100644
--- a/files/ru/web/javascript/reference/global_objects/map/index.html
+++ b/files/ru/web/javascript/reference/global_objects/map/index.html
@@ -78,7 +78,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Map
  
Map.prototype.entries()

  
Возвращает новый объект Iterator который содержит массив [key, value] для каждого элемента в объекте Map в порядке вставки.

  
Map.prototype.forEach(callbackFn[, thisArg])

- 
Вызывает callbackFn один раз для каждой пары ключ-значение, присутствующей в объекте Map, в порядке вставки. Если для thisArg предоставляется параметр для forEach, он будет использоваться как значение this для каждого обратного вызова.

+ 
Вызывает callbackFn один раз для каждой пары ключ-значение, присутствующей в объекте Map, в порядке вставки. Если для thisArg предоставляется параметр для forEach, он будет использоваться как значение this для каждого колбэка.

  
Map.prototype.get(key)

  
Возвращает значение связанное с key, или undefined если его нет.

  
Map.prototype.has(key)

diff --git a/files/ru/web/javascript/reference/global_objects/object/create/index.html b/files/ru/web/javascript/reference/global_objects/object/create/index.html
index 5966fd0d23..bb1da1642e 100644
--- a/files/ru/web/javascript/reference/global_objects/object/create/index.html
+++ b/files/ru/web/javascript/reference/global_objects/object/create/index.html
@@ -170,7 +170,7 @@ o2 = Object.create({}, {
     var hasOwn = Object.prototype.hasOwnProperty;
 
     return function (O) {
-      // 1. Если Type(O) не является Object or Null выдается исключениеTypeError.
+      // 1. Если Type(O) не является Object or Null выдается исключение TypeError.
       if (typeof O != 'object') {
         throw TypeError('Object prototype may only be an Object or null');
       }
diff --git a/files/ru/web/javascript/reference/operators/function/index.html b/files/ru/web/javascript/reference/operators/function/index.html
index 7e69430938..fe6bf05dac 100644
--- a/files/ru/web/javascript/reference/operators/function/index.html
+++ b/files/ru/web/javascript/reference/operators/function/index.html
@@ -89,7 +89,7 @@ console.log(bar === baz); // false (errors because baz == undefined)

 };
 

 
-
Преимущественно анонимные функции используются как {{Glossary("функция обратного вызова", "функции обратного вызова", 1)}}.

+
Преимущественно анонимные функции используются как {{Glossary("колбэк-функция", "колбэк-функции", 1)}}.

 
 
button.addEventListener('click', function(event) {
     console.log('button is clicked!')
diff --git a/files/ru/web/javascript/reference/operators/optional_chaining/index.html b/files/ru/web/javascript/reference/operators/optional_chaining/index.html
index a51882e0d6..959d17c800 100644
--- a/files/ru/web/javascript/reference/operators/optional_chaining/index.html
+++ b/files/ru/web/javascript/reference/operators/optional_chaining/index.html
@@ -56,9 +56,9 @@ let nestedProp = ((temp === null || temp === undefined) ? undefined : temp.secon
 
Обратите внимание: Для существующего свойства, не являющегося функцией, использование конструкции x.y?.() всё равно выбросит {{jsxref("TypeError")}} исключение (x.y не является функцией).

 
 
-
Работа с функциями обратного вызова и обработчиками событий

+
Работа с колбэк-функциями и обработчиками событий

 
-
Если Вы используете функции обратного вызова или извлекаете методы объекта деструктурирующим присваиванием, Вы можете получить несуществующие значения, которые нельзя вызывать как функции до проверки на их существование. Используя оператор ?., Вы можете избежать лишних проверок:

+
Если Вы используете колбэк-функции или извлекаете методы объекта деструктурирующим присваиванием, Вы можете получить несуществующие значения, которые нельзя вызывать как функции до проверки на их существование. Используя оператор ?., Вы можете избежать лишних проверок:

 
 
// С использованием ES2019
 function doSomething(onContent, onError) {
diff --git a/files/ru/web/javascript/reference/statements/async_function/index.html b/files/ru/web/javascript/reference/statements/async_function/index.html
index 31bcaad8c0..966ea49b80 100644
--- a/files/ru/web/javascript/reference/statements/async_function/index.html
+++ b/files/ru/web/javascript/reference/statements/async_function/index.html
@@ -42,7 +42,7 @@ translation_of: Web/JavaScript/Reference/Statements/async_function
 
Ключевое слово await допустимо только в асинхронных функциях. В другом контексте вы получите ошибку SyntaxError.

 
 

-
Цель функций async/await упростить использование promises синхронно и воспроизвести некоторое действие над группой  Promises. Точно так же как Promises подобны структурированным callback-ам, async/await подобна комбинации генераторов и promises.

+
Цель функций async/await упростить использование promises синхронно и воспроизвести некоторое действие над группой  Promises. Точно так же как Promises подобны структурированным колбэкам, async/await подобна комбинации генераторов и promises.

 

 
 
Примеры

-- 
cgit v1.2.3-54-g00ecf