Возвратные функции

оригинал:http://ruseller.com/lessons.php?rub=28&id=1371

---

Если у вас есть хотя бы небольшой опыт работы с JavaScript, то наверняка вы уже использовали возвратные функции. Но может быть, полного понимания о том, как они работают, нет.

Что такое возвратная функция?

Статья из Википедии, на которую мы ссылаемся выше, хорошо описывает возвратную функцию как " передача исполняемого кода в качестве одного из параметров другого кода".

Вот простой и распространенный пример, взятый из jQuery:

$('#element').fadeIn('slow', function() { 
   // код возвратной функции 
});

Здесь осуществляется вызов метода jQuery fadeIn(). Данный метод принимает два аргумента: скорость проявления и возвратную функцию (опционально). В коде функции можно выполнять все, что угодно.

Когда метод fadeIn() завершает выполнение, то выполняется возвратная функция(если она присутствует). Поэтому, в зависимости от выбранной скорости, перед запуском кода возвратной функции будет иметься задержка.

Как написать возвратную функцию

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

function mySandwich(param1, param2, callback) { 
   alert('Начинаем есть бутерброд.\n\nПараметры: ' + param1 + ', ' + param2); 
   callback(); 
} 
mySandwich('ветчина', 'сыр', function() { 
   alert('Заканчиваем есть бутерброд.'); 
}); 

Здесь у нас есть функция mySandwich, которая принимает три параметра. Третий параметр - возвратная функция. Когда основная функция выполняется, она генерирует сообщение с выводом переданных параметров. А затем выполняется возвратная функция.

Обратите внимание на параметр “callback” (без скобок). Когда выполняется возвратная функция, нужно использовать скобки. Вы можете называть данный параметр так, как нужно.

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

Делаем использование возвратной функции опциональным

Возвратные функции в jQuery являются опциональными. То есть, метод принимает возвратные функции, но если она не будет использована, то все будет работать без нее. В нашем простом примере страница вернет ошибку, если функция будет вызвана без обратной функции, например, так:

function mySandwich(param1, param2, callback) { 
   alert('Начинаем есть бутерброд.\n\nПараметры: ' + param1 + ', ' + param2); 
   callback(); 
} 
mySandwich('ветчина', 'сыр'); 

Действие кода можно посмотреть здесь. если открыть консоль разработчика, то вы увидите сообщение об ошибке “callback is not a function” (парметр callback не является функцией), которое будет появляться после первоначального вызова функции alert.

Чтобы сделать возвратную функцию опциональной, нужно изменить код:

function mySandwich(param1, param2, callback) { 
   alert('Начинаем есть бутерброд.\n\nПараметры: ' + param1 + ', ' + param2); 
   if (callback) { 
       callback(); 
   } 
mySandwich('ветчина', 'сыр'); 

Теперь осуществляется проверка наличия функции callback, и код выполняется без ошибок.

Проверяем правильность возвратной функции

Для создания завершенного кода нужно проверить переданной значение третьего аргумента на соответствие типа:

function mySandwich(param1, param2, callback) { 
   alert('Начинаем есть бутерброт.\n\nПараметры: ' + param1 + ', ' + param2); 
   if (callback && typeof(callback) === "function") { 
       callback(); 
   } 
} 
mySandwich('ветчина', 'сыр', 'овощи'); 

Теперь функция выполняет проверку с помощью оператора typeof, чтобы убедиться, что третий параметр действительно является функцией. В примере третий аргумент является строкой. Но проверка с использованием typeof помогает избежать ошибки.

Замечания о времени выполнения

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

Вот пример с использованием метода jQuery animate:

function mySandwich(param1, param2, callback) {
   alert('Начинаем есть бутерброд.\n\nПараметры: ' + param1 + ', ' + param2);
   $('#sandwich').animate({
       opacity: 0
   }, 5000, function() {
       // Анимация завершена.
   });
   if (callback && typeof(callback) === "function") {
       callback();
   }
}
mySandwich('ветчина', 'сыр', function() {
   alert('Заканчиваем есть бутерброд.');
});

Обратите внимание, что хотя возвратная функция расположена в коде позже анимации, она выполняется задолго до того, как завершится анимация. В данном случае решение задачи достаточно простое: нужно поместить вызов возвратной функции в метод animate (то есть, где располагается комментарий “Анимация завершена”).

Данный пункт не закрывает все вопросы, которые появляются при использовании асинхронных функций, а служит только предупреждением для активации повышенного внимания в таких случаях.