Документация по угловому материалу $ mdDialog.finally?

Question

Из documentation, диалоговых окон в угловом Материале имеет подпись так:

function showAlert() { 
    alert = $mdDialog.alert() 
    .title('Attention, ' + $scope.userName) 
    .content('This is an example of how easy dialogs can be!') 
    .ok('Close'); 
    $mdDialog 
     .show(alert) 
     .finally(function() { 
     alert = undefined; 
     }); 
} 

Я не могу найти никакой документацию по .finally. Похоже, это функция обратного вызова из того, что я могу собрать, хотя в документации странно отсутствует какая-либо информация.

Должен ли я считать, что это нормальная функция обратного вызова, и почему документация по ней отсутствует? Это просто такой стандартный директивный синтаксис, что предполагается, что это способ справиться с обратными вызовами, например .then?

Благодарим за любую информацию.

Answer 1

$mdDialog.show() возвращает обещание. finally - это действие, которое вы выполняете по завершении обещания, независимо от того, было ли оно разрешено или отклонено. Как правило, finally используется для обработки любых действий по очистке после завершения обещания (как это делается здесь, очищая переменную alert).

Угловые использует q библиотеки для обработки обещаний, так что вы можете найти информацию о методе finally() в Q API Reference