--@angularjs--理解Angular中的$apply,以及$digest

$apply() 和 $digest() 在 AngularJS 中是两个核心概念,但是有时候它们又让人困惑。而为了了解 AngularJS 的工作方式,首先需要了解 $apply() 和 $digest() 是如何工作的。这篇文章旨在解释 $apply() 和 $digest() 是什么,以及在日常的编码中如何应用它们。

探索 $apply() 和 $digest()

AngularJS 提供了一个非常酷的特性叫做双向数据绑定 (Two-way Data Binding) ,这个特性大大简化了我们的代码编写方式。数据绑定意味着当 View 中有任何数据发生了变化,那么这个变化也会自动地反馈到 scope 的数据上,也即意味着 scope 模型会自动地更新。类似地,当 scope 模型发生变化时, view 中的数据也会更新到最新的值。那么 AngularJS 是如何做到这一点的呢?当你写下表达式如 {{ aModel }} 时, AngularJS 在幕后会为你在 scope 模型上设置一个 watcher ,它用来在数据发生变化的时候更新 view 。这里的 watcher 和你会在 AngularJS 中设置的 watcher 是一样的:

$scope.$watch('aModel', function(newValue, oldValue) {
  //update the DOM with newValue
});

传入到 $watch() 中的第二个参数是一个回调函数,该函数在 aModel 的值发生变化的时候会被调用。当 aModel 发生变化的时候,这个回调函数会被调用来更新 view 这一点不难理解,但是,还存在一个很重要的问题! AngularJS 是如何知道什么时候要调用这个回调函数呢?换句话说, AngularJS 是如何知晓 aModel 发生了变化,才调用了对应的回调函数呢?它会周期性的运行一个函数来检查 scope 模型中的数据是否发生了变化吗?好吧,这就是 $digest 循环的用武之地了。

在 $digest 循环中, watchers 会被触发。当一个 watcher 被触发时, AngularJS 会检测 scope 模型,如何它发生了变化那么关联到该 watcher 的回调函数就会被调用。那么,下一个问题就是 $digest 循环是在什么时候以各种方式开始的?

在调用了 $scope.$digest() 后, $digest 循环就开始了。假设你在一个 ng-click 指令对应的 handler 函数中更改了 scope 中的一条数据,此时 AngularJS 会自动地通过调用 $digest() 来触发一轮 $digest 循环。当 $digest 循环开始后,它会触发每个 watcher 。这些 watchers 会检查 scope 中的当前 model 值是否和上一次计算得到的 model 值不同。如果不同,那么对应的回调函数会被执行。调用该函数的结果,就是 view 中的表达式内容 ( 译注:诸如 {{ aModel }}) 会被更新。除了 ng-click 指令,还有一些其它的 built-in 指令以及服务来让你更改 models( 比如 ng-model , $timeout 等 ) 和自动触发一次 $digest 循环。

目前为止还不错!但是,有一个小问题。在上面的例子中, AngularJS 并不直接调用 $digest() ,而是调用 $scope.$apply() ,后者会调用 $rootScope.$digest() 。因此,一轮 $digest 循环在 $rootScope 开始,随后会访问到所有的 children scope 中的 watchers 。

现在,假设你将 ng-click 指令关联到了一个 button 上,并传入了一个 function 名到 ng-click 上。当该 button 被点击时, AngularJS 会将此 function 包装到一个 wrapping function 中,然后传入到 $scope.$apply() 。因此,你的 function 会正常被执行,修改 models( 如果需要的话 ) ,此时一轮 $digest 循环也会被触发,用来确保 view 也会被更新。

Note: $scope.$apply() 会自动地调用 $rootScope.$digest() 。 $apply() 方法有两种形式。第一种会接受一个 function 作为参数,执行该 function 并且触发一轮 $digest 循环。第二种会不接受任何参数,只是触发一轮 $digest 循环。我们马上会看到为什么第一种形式更好。

什么时候手动调用 $apply() 方法?

如果 AngularJS 总是将我们的代码 wrap 到一个 function 中并传入 $apply() ,以此来开始一轮 $digest 循环,那么什么时候才需要我们手动地调用 $apply() 方法呢?实际上, AngularJS 对此有着非常明确的要求,就是它只负责对发生于 AngularJS 上下文环境中的变更会做出自动地响应 ( 即,在 $apply() 方法中发生的对于 models 的更改 ) 。 AngularJS 的 built-in 指令就是这样做的,所以任何的 model 变更都会被反映到 view 中。但是,如果你在 AngularJS 上下文之外的任何地方修改了 model ,那么你就需要通过手动调用 $apply() 来通知 AngularJS 。这就像告诉 AngularJS ,你修改了一些 models ,希望 AngularJS 帮你触发 watchers 来做出正确的响应。

比如,如果你使用了 JavaScript 中的 setTimeout() 来更新一个 scope model ,那么 AngularJS 就没有办法知道你更改了什么。这种情况下,调用 $apply() 就是你的责任了,通过调用它来触发一轮 $digest 循环。类似地,如果你有一个指令用来设置一个 DOM 事件 listener 并且在该 listener 中修改了一些 models ,那么你也需要通过手动调用 $apply() 来确保变更会被正确的反映到 view 中。

让我们来看一个例子。加入你有一个页面,一旦该页面加载完毕了,你希望在两秒钟之后显示一条信息。你的实现可能是下面这个样子的:

HTML:

<body ng-app="myApp">
  <div ng-controller="MessageController">
    Delayed Message: {{message}}
  </div>  
</body>

JavaScript:

/* What happens without an $apply() */
    
    angular.module('myApp',[]).controller('MessageController', function($scope) {
    
      $scope.getMessage = function() {
        setTimeout(function() {
          $scope.message = 'Fetched after 3 seconds';
          console.log('message:'+$scope.message);
        }, 2000);
      }
      
      $scope.getMessage();
    
    });

通过运行这个例子,你会看到过了两秒钟之后,控制台确实会显示出已经更新的 model ,然而, view 并没有更新。原因也许你已经知道了,就是我们忘了调用 $apply() 方法。因此,我们需要修改 getMessage() ,如下所示:

/* What happens with $apply */ 
angular.module('myApp',[]).controller('MessageController', function($scope) {
    
      $scope.getMessage = function() {
        setTimeout(function() {
          $scope.$apply(function() {
            //wrapped this within $apply
            $scope.message = 'Fetched after 3 seconds'; 
            console.log('message:' + $scope.message);
          });
        }, 2000);
      }
      
      $scope.getMessage();
    
    });

如果你运行了上面的例子,你会看到 view 在两秒钟之后也会更新。唯一的变化是我们的代码现在被 wrapped 到了 $scope.$apply() 中,它会自动触发 $rootScope.$digest() ,从而让 watchers 被触发用以更新 view 。

Note: 顺便提一下,你应该使用 $timeout service 来代替 setTimeout() ,因为前者会帮你调用 $apply() ,让你不需要手动地调用它。

而且,注意在以上的代码中你也可以在修改了 model 之后手动调用没有参数的 $apply() ,就像下面这样:

$scope.getMessage = function() {
  setTimeout(function() {
    $scope.message = 'Fetched after two seconds';
    console.log('message:' + $scope.message);
    $scope.$apply(); //this triggers a $digest
  }, 2000);
};

以上的代码使用了 $apply() 的第二种形式,也就是没有参数的形式。需要记住的是你总是应该使用接受一个 function 作为参数的 $apply() 方法。这是因为当你传入一个 function 到 $apply() 中的时候,这个 function 会被包装到一个 try … catch 块中,所以一旦有异常发生,该异常会被 $exceptionHandler service 处理。

$digest 循环会运行多少次?

当一个 $digest 循环运行时, watchers 会被执行来检查 scope 中的 models 是否发生了变化。如果发生了变化,那么相应的 listener 函数就会被执行。这涉及到一个重要的问题。如果 listener 函数本身会修改一个 scope model 呢? AngularJS 会怎么处理这种情况?

答案是 $digest 循环不会只运行一次。在当前的一次循环结束后,它会再执行一次循环用来检查是否有 models 发生了变化。这就是脏检查 (Dirty Checking) ,它用来处理在 listener 函数被执行时可能引起的 model 变化。因此, $digest 循环会持续运行直到 model 不再发生变化,或者 $digest 循环的次数达到了 10 次。因此,尽可能地不要在 listener 函数中修改 model 。

Note: $digest 循环最少也会运行两次,即使在 listener 函数中并没有改变任何 model 。正如上面讨论的那样,它会多运行一次来确保 models 没有变化。

结语

我希望这篇文章解释清楚了 $apply 和 $digest 。需要记住的最重要的是 AngularJS 是否能检测到你对于 model 的修改。如果它不能检测到,那么你就需要手动地调用 $apply() 。