关于 Angular Material $mdDialog.finally 的文档?

Documentation on Angular Material $mdDialog.finally?

documentation 开始,Angular Material 中的对话框有这样的签名:

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

感谢您提供任何信息。

$mdDialog.show()returns一个承诺。 finally 是您在完成承诺时采取的行动,无论它是已解决还是已拒绝。通常,finally 用于处理 promise 完成后应该完成的任何清理工作(就像这里通过清除 alert 变量所做的那样)。

Angular 使用 q 库来处理承诺,因此您可以在 Q API Reference

找到有关 finally() 方法的信息