angular.js/test/ScopeSpec.js

'use strict';

describe('Scope', function(){
  var root, mockHandler;

  beforeEach(function(){
    root = createScope(angular.service, {
      $updateView: function(){
        root.$flush();
      },
      '$exceptionHandler': $exceptionHandlerMockFactory()
    });
    mockHandler = root.$service('$exceptionHandler');
  });


  describe('$root', function(){
    it('should point to itself', function(){
      expect(root.$root).toEqual(root);
      expect(root.hasOwnProperty('$root')).toBeTruthy();
    });


    it('should not have $root on children, but should inherit', function(){
      var child = root.$new();
      expect(child.$root).toEqual(root);
      expect(child.hasOwnProperty('$root')).toBeFalsy();
    });

  });


  describe('$parent', function(){
    it('should point to itself in root', function(){
      expect(root.$root).toEqual(root);
    });


    it('should point to parent', function(){
      var child = root.$new();
      expect(root.$parent).toEqual(null);
      expect(child.$parent).toEqual(root);
      expect(child.$new().$parent).toEqual(child);
    });
  });


  describe('$id', function(){
    it('should have a unique id', function(){
      expect(root.$id < root.$new().$id).toBeTruthy();
    });
  });


  describe('this', function(){
    it('should have a \'this\'', function(){
      expect(root['this']).toEqual(root);
    });
  });


  describe('$new()', function(){
    it('should create a child scope', function(){
      var child = root.$new();
      root.a = 123;
      expect(child.a).toEqual(123);
    });


    it('should instantiate controller and bind functions', function(){
      function Cntl($browser, name){
        this.$browser = $browser;
        this.callCount = 0;
        this.name = name;
      }
      Cntl.$inject = ['$browser'];

      Cntl.prototype = {
        myFn: function(){
          expect(this).toEqual(cntl);
          this.callCount++;
        }
      };

      var cntl = root.$new(Cntl, ['misko']);

      expect(root.$browser).toBeUndefined();
      expect(root.myFn).toBeUndefined();

      expect(cntl.$browser).toBeDefined();
      expect(cntl.name).toEqual('misko');

      cntl.myFn();
      cntl.$new().myFn();
      expect(cntl.callCount).toEqual(2);
    });
  });


  describe('$service', function(){
    it('should have it on root', function(){
      expect(root.hasOwnProperty('$service')).toBeTruthy();
    });
  });


  describe('$watch/$digest', function(){
    it('should watch and fire on simple property change', function(){
      var spy = jasmine.createSpy();
      root.$watch('name', spy);
      expect(spy).not.wasCalled();
      root.$digest();
      expect(spy).not.wasCalled();
      root.name = 'misko';
      root.$digest();
      expect(spy).wasCalledWith(root, 'misko', undefined);
    });


    it('should watch and fire on expression change', function(){
      var spy = jasmine.createSpy();
      root.$watch('name.first', spy);
      root.name = {};
      expect(spy).not.wasCalled();
      root.$digest();
      expect(spy).not.wasCalled();
      root.name.first = 'misko';
      root.$digest();
      expect(spy).wasCalled();
    });

    it('should delegate exceptions', function(){
      root.$watch('a', function(){throw new Error('abc');});
      root.a = 1;
      root.$digest();
      expect(mockHandler.errors[0].message).toEqual('abc');
      $logMock.error.logs.length = 0;
    });


    it('should fire watches in order of addition', function(){
      // this is not an external guarantee, just our own sanity
      var log = '';
      root.$watch('a', function(){ log += 'a'; });
      root.$watch('b', function(){ log += 'b'; });
      root.$watch('c', function(){ log += 'c'; });
      root.a = root.b = root.c = 1;
      root.$digest();
      expect(log).toEqual('abc');
    });


    it('should delegate $digest to children in addition order', function(){
      // this is not an external guarantee, just our own sanity
      var log = '';
      var childA = root.$new();
      var childB = root.$new();
      var childC = root.$new();
      childA.$watch('a', function(){ log += 'a'; });
      childB.$watch('b', function(){ log += 'b'; });
      childC.$watch('c', function(){ log += 'c'; });
      childA.a = childB.b = childC.c = 1;
      root.$digest();
      expect(log).toEqual('abc');
    });


    it('should repeat watch cycle while model changes are identified', function(){
      var log = '';
      root.$watch('c', function(self, v){self.d = v; log+='c'; });
      root.$watch('b', function(self, v){self.c = v; log+='b'; });
      root.$watch('a', function(self, v){self.b = v; log+='a'; });
      root.a = 1;
      expect(root.$digest()).toEqual(3);
      expect(root.b).toEqual(1);
      expect(root.c).toEqual(1);
      expect(root.d).toEqual(1);
      expect(log).toEqual('abc');
    });


    it('should prevent infinite recursion', function(){
      root.$watch('a', function(self, v){self.b++;});
      root.$watch('b', function(self, v){self.a++;});
      root.a = root.b = 0;

      expect(function(){
        root.$digest();
      }).toThrow('100 $digest() iterations reached. Aborting!');
    });


    it('should not fire upon $watch registration on initial $digest', function(){
      var log = '';
      root.a = 1;
      root.$watch('a', function(){ log += 'a'; });
      root.$watch('b', function(){ log += 'b'; });
      expect(log).toEqual('');
      expect(root.$digest()).toEqual(0);
      expect(log).toEqual('');
    });


    it('should return the listener to force a initial watch', function(){
      var log = '';
      root.a = 1;
      root.$watch('a', function(scope, o1, o2){ log += scope.a + ':' + (o1 == o2 == 1) ; })();
      expect(log).toEqual('1:true');
      expect(root.$digest()).toEqual(0);
      expect(log).toEqual('1:true');
    });


    it('should watch objects', function(){
      var log = '';
      root.a = [];
      root.b = {};
      root.$watch('a', function(){ log +='.';});
      root.$watch('b', function(){ log +='!';});
      root.$digest();
      expect(log).toEqual('');

      root.a.push({});
      root.b.name = '';

      root.$digest();
      expect(log).toEqual('.!');
    });


    it('should prevent recursion', function(){
      var callCount = 0;
      root.$watch('name', function(){
        expect(function(){
          root.$digest();
        }).toThrow('$digest already in progress');
        expect(function(){
          root.$flush();
        }).toThrow('$digest already in progress');
        callCount++;
      });
      root.name = 'a';
      root.$digest();
      expect(callCount).toEqual(1);
    });
  });


  describe('$observe/$flush', function(){
    it('should register simple property observer and fire on change', function(){
      var spy = jasmine.createSpy();
      root.$observe('name', spy);
      expect(spy).not.wasCalled();
      root.$flush();
      expect(spy).wasCalled();
      expect(spy.mostRecentCall.args[0]).toEqual(root);
      expect(spy.mostRecentCall.args[1]).toEqual(undefined);
      expect(spy.mostRecentCall.args[2].toString()).toEqual(NaN.toString());
      root.name = 'misko';
      root.$flush();
      expect(spy).wasCalledWith(root, 'misko', undefined);
    });


    it('should register expression observers and fire them on change', function(){
      var spy = jasmine.createSpy();
      root.$observe('name.first', spy);
      root.name = {};
      expect(spy).not.wasCalled();
      root.$flush();
      expect(spy).wasCalled();
      root.name.first = 'misko';
      root.$flush();
      expect(spy).wasCalled();
    });


    it('should delegate exceptions', function(){
      root.$observe('a', function(){throw new Error('abc');});
      root.a = 1;
      root.$flush();
      expect(mockHandler.errors[0].message).toEqual('abc');
      $logMock.error.logs.shift();
    });


    it('should fire observers in order of addition', function(){
      // this is not an external guarantee, just our own sanity
      var log = '';
      root.$observe('a', function(){ log += 'a'; });
      root.$observe('b', function(){ log += 'b'; });
      root.$observe('c', function(){ log += 'c'; });
      root.a = root.b = root.c = 1;
      root.$flush();
      expect(log).toEqual('abc');
    });


    it('should delegate $flush to children in addition order', function(){
      // this is not an external guarantee, just our own sanity
      var log = '';
      var childA = root.$new();
      var childB = root.$new();
      var childC = root.$new();
      childA.$observe('a', function(){ log += 'a'; });
      childB.$observe('b', function(){ log += 'b'; });
      childC.$observe('c', function(){ log += 'c'; });
      childA.a = childB.b = childC.c = 1;
      root.$flush();
      expect(log).toEqual('abc');
    });


    it('should fire observers once at beggining and on change', function(){
      var log = '';
      root.$observe('c', function(self, v){self.d = v; log += 'c';});
      root.$observe('b', function(self, v){self.c = v; log += 'b';});
      root.$observe('a', function(self, v){self.b = v; log += 'a';});
      root.a = 1;
      root.$flush();
      expect(root.b).toEqual(1);
      expect(log).toEqual('cba');
      root.$flush();
      expect(root.c).toEqual(1);
      expect(log).toEqual('cbab');
      root.$flush();
      expect(root.d).toEqual(1);
      expect(log).toEqual('cbabc');
    });


    it('should fire on initial observe', function(){
      var log = '';
      root.a = 1;
      root.$observe('a', function(){ log += 'a'; });
      root.$observe('b', function(){ log += 'b'; });
      expect(log).toEqual('');
      root.$flush();
      expect(log).toEqual('ab');
    });


    it('should observe objects', function(){
      var log = '';
      root.a = [];
      root.b = {};
      root.$observe('a', function(){ log +='.';});
      root.$observe('a', function(){ log +='!';});
      root.$flush();
      expect(log).toEqual('.!');

      root.$flush();
      expect(log).toEqual('.!');

      root.a.push({});
      root.b.name = '';

      root.$digest();
      expect(log).toEqual('.!');
    });


    it('should prevent recursion', function(){
      var callCount = 0;
      root.$observe('name', function(){
        expect(function(){
          root.$digest();
        }).toThrow('$flush already in progress');
        expect(function(){
          root.$flush();
        }).toThrow('$flush already in progress');
        callCount++;
      });
      root.name = 'a';
      root.$flush();
      expect(callCount).toEqual(1);
    });
  });


  describe('$destroy', function(){
    var first, middle, last, log;

    beforeEach(function(){
      log = '';

      first = root.$new();
      middle = root.$new();
      last = root.$new();

      first.$watch(function(){ log += '1';});
      middle.$watch(function(){ log += '2';});
      last.$watch(function(){ log += '3';});

      log = '';
    });


    it('should ignore remove on root', function(){
      root.$destroy();
      root.$digest();
      expect(log).toEqual('123');
    });


    it('should remove first', function(){
      first.$destroy();
      root.$digest();
      expect(log).toEqual('23');
    });


    it('should remove middle', function(){
      middle.$destroy();
      root.$digest();
      expect(log).toEqual('13');
    });


    it('should remove last', function(){
      last.$destroy();
      root.$digest();
      expect(log).toEqual('12');
    });
  });


  describe('$eval', function(){
    it('should eval an expression', function(){
      expect(root.$eval('a=1')).toEqual(1);
      expect(root.a).toEqual(1);

      root.$eval(function(self){self.b=2;});
      expect(root.b).toEqual(2);
    });
  });


  describe('$apply', function(){
    it('should apply expression with full lifecycle', function(){
      var log = '';
      var child = root.$new();
      root.$watch('a', function(scope, a){ log += '1'; });
      root.$observe('a', function(scope, a){ log += '2'; });
      child.$apply('$parent.a=0');
      expect(log).toEqual('12');
    });


    it('should catch exceptions', function(){
      var log = '';
      var child = root.$new();
      root.$watch('a', function(scope, a){ log += '1'; });
      root.$observe('a', function(scope, a){ log += '2'; });
      root.a = 0;
      child.$apply(function(){ throw new Error('MyError'); });
      expect(log).toEqual('12');
      expect(mockHandler.errors[0].message).toEqual('MyError');
      $logMock.error.logs.shift();
    });


    describe('exceptions', function(){
      var $exceptionHandler, $updateView, log;
      beforeEach(function(){
        log = '';
        $exceptionHandler = jasmine.createSpy('$exceptionHandler');
        $updateView = jasmine.createSpy('$updateView');
        root.$service = function(name) {
          return {$updateView:$updateView, $exceptionHandler:$exceptionHandler}[name];
        };
        root.$watch(function(){ log += '$digest;'; });
        log = '';
      });


      it('should execute and return value and update', function(){
        root.name = 'abc';
        expect(root.$apply(function(scope){
          return scope.name;
        })).toEqual('abc');
        expect(log).toEqual('$digest;');
        expect($exceptionHandler).not.wasCalled();
        expect($updateView).wasCalled();
      });


      it('should catch exception and update', function(){
        var error = new Error('MyError');
        root.$apply(function(){ throw error; });
        expect(log).toEqual('$digest;');
        expect($exceptionHandler).wasCalledWith(error);
        expect($updateView).wasCalled();
      });
    });
  });
});