move(scope): appease the History God

-	renamed:    src/Scope.js -> src/service/scope.js
-	renamed:    test/ScopeSpec.js -> test/service/scopeSpec.js

1 files changed, 717 insertions, 0 deletions

diff --git a/test/service/scopeSpec.js b/test/service/scopeSpec.js
new file mode 100644
index 00000000..d3f58918
--- /dev/null
+++ b/test/service/scopeSpec.js
@@ -0,0 +1,717 @@
+'use strict';
+
+describe('Scope', function() {
+  var root = null, mockHandler = null;
+
+  beforeEach(function() {
+    root = createScope(angular.service, {
+      '$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);
+      root.$digest();
+      spy.reset();
+
+      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.$digest();
+      spy.reset();
+
+      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 call child $watchers 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 allow $digest on a child scope with and without a right sibling', function() {
+      // tests a traversal edge case which we originally missed
+      var log = '',
+          childA = root.$new(),
+          childB = root.$new();
+
+      root.$watch(function() { log += 'r'; });
+      childA.$watch(function() { log += 'a'; });
+      childB.$watch(function() { log += 'b'; });
+
+      // init
+      root.$digest();
+      expect(log).toBe('rabrab');
+
+      log = '';
+      childA.$digest();
+      expect(log).toBe('a');
+
+      log = '';
+      childB.$digest();
+      expect(log).toBe('b');
+    });
+
+
+    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.$digest();
+      log = '';
+      root.a = 1;
+      root.$digest();
+      expect(root.b).toEqual(1);
+      expect(root.c).toEqual(1);
+      expect(root.d).toEqual(1);
+      expect(log).toEqual('abc');
+    });
+
+
+    it('should repeat watch cycle from the root elemnt', function() {
+      var log = '';
+      var child = root.$new();
+      root.$watch(function() { log += 'a'; });
+      child.$watch(function() { log += 'b'; });
+      root.$digest();
+      expect(log).toEqual('abab');
+    });
+
+
+    it('should prevent infinite recursion and print watcher expression', function() {
+      root.$watch('a', function(self){self.b++;});
+      root.$watch('b', function(self){self.a++;});
+      root.a = root.b = 0;
+
+      expect(function() {
+        root.$digest();
+      }).toThrow('100 $digest() iterations reached. Aborting!\n'+
+          'Watchers fired in the last 5 iterations: ' +
+          '[["a","b"],["a","b"],["a","b"],["a","b"],["a","b"]]');
+    });
+
+
+    it('should prevent infinite recurcion and print print watcher function name or body',
+        function() {
+      root.$watch(function watcherA() {return root.a;}, function(self){self.b++;});
+      root.$watch(function() {return root.b;}, function(self){self.a++;});
+      root.a = root.b = 0;
+
+      try {
+        root.$digest();
+        throw Error('Should have thrown exception');
+      } catch(e) {
+        expect(e.message.match(/"fn: (watcherA|function)/g).length).toBe(10);
+      }
+    });
+
+
+    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'; });
+      root.$digest();
+      log = '';
+      root.$digest();
+      expect(log).toEqual('');
+    });
+
+
+    it('should watch objects', function() {
+      var log = '';
+      root.a = [];
+      root.b = {};
+      root.$watch('a', function(scope, value){
+        log +='.';
+        expect(value).toBe(root.a);
+      });
+      root.$watch('b', function(scope, value){
+        log +='!';
+        expect(value).toBe(root.b);
+      });
+      root.$digest();
+      log = '';
+
+      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');
+        callCount++;
+      });
+      root.name = 'a';
+      root.$digest();
+      expect(callCount).toEqual(1);
+    });
+
+
+    it('should return a function that allows listeners to be unregistered', function() {
+      var root = angular.scope(),
+          listener = jasmine.createSpy('watch listener'),
+          listenerRemove;
+
+      listenerRemove = root.$watch('foo', listener);
+      root.$digest(); //init
+      expect(listener).toHaveBeenCalled();
+      expect(listenerRemove).toBeDefined();
+
+      listener.reset();
+      root.foo = 'bar';
+      root.$digest(); //triger
+      expect(listener).toHaveBeenCalledOnce();
+
+      listener.reset();
+      root.foo = 'baz';
+      listenerRemove();
+      root.$digest(); //trigger
+      expect(listener).not.toHaveBeenCalled();
+    });
+  });
+
+
+  describe('$destroy', function() {
+    var first = null, middle = null, last = null, log = null;
+
+    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';});
+
+      root.$digest();
+      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');
+    });
+
+    it('should fire a $destroy event', function() {
+      var destructedScopes = [];
+      middle.$on('$destroy', function(event) {
+        destructedScopes.push(event.currentScope);
+      });
+      middle.$destroy();
+      expect(destructedScopes).toEqual([middle]);
+    });
+
+  });
+
+
+  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('$evalAsync', function() {
+
+    it('should run callback before $watch', function() {
+      var log = '';
+      var child = root.$new();
+      root.$evalAsync(function(scope){ log += 'parent.async;'; });
+      root.$watch('value', function() { log += 'parent.$digest;'; });
+      child.$evalAsync(function(scope){ log += 'child.async;'; });
+      child.$watch('value', function() { log += 'child.$digest;'; });
+      root.$digest();
+      expect(log).toEqual('parent.async;parent.$digest;child.async;child.$digest;');
+    });
+
+    it('should cause a $digest rerun', function() {
+      root.log = '';
+      root.value = 0;
+      root.$watch('value', 'log = log + ".";');
+      root.$watch('init', function() {
+        root.$evalAsync('value = 123; log = log + "=" ');
+        expect(root.value).toEqual(0);
+      });
+      root.$digest();
+      expect(root.log).toEqual('.=.');
+    });
+
+    it('should run async in the same order as added', function() {
+      root.log = '';
+      root.$evalAsync("log = log + 1");
+      root.$evalAsync("log = log + 2");
+      root.$digest();
+      expect(root.log).toBe('12');
+    });
+
+  });
+
+
+  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'; });
+      child.$apply('$parent.a=0');
+      expect(log).toEqual('1');
+    });
+
+
+    it('should catch exceptions', function() {
+      var log = '';
+      var child = root.$new();
+      root.$watch('a', function(scope, a){ log += '1'; });
+      root.a = 0;
+      child.$apply(function() { throw new Error('MyError'); });
+      expect(log).toEqual('1');
+      expect(mockHandler.errors[0].message).toEqual('MyError');
+      $logMock.error.logs.shift();
+    });
+
+
+    describe('exceptions', function() {
+      var $exceptionHandler, log;
+      beforeEach(function() {
+        log = '';
+        $exceptionHandler = jasmine.createSpy('$exceptionHandler');
+        root.$service = function(name) {
+          return {$exceptionHandler:$exceptionHandler}[name];
+        };
+        root.$watch(function() { log += '$digest;'; });
+        root.$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();
+      });
+
+
+      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);
+      });
+    });
+  });
+
+
+  describe('events', function() {
+
+    describe('$on', function() {
+
+      it('should add listener for both $emit and $broadcast events', function() {
+        var log = '',
+            root = angular.scope(),
+            child = root.$new();
+
+        function eventFn() {
+          log += 'X';
+        }
+
+        child.$on('abc', eventFn);
+        expect(log).toEqual('');
+
+        child.$emit('abc');
+        expect(log).toEqual('X');
+
+        child.$broadcast('abc');
+        expect(log).toEqual('XX');
+      });
+
+
+      it('should return a function that deregisters the listener', function() {
+        var log = '',
+            root = angular.scope(),
+            child = root.$new(),
+            listenerRemove;
+
+        function eventFn() {
+          log += 'X';
+        }
+
+        listenerRemove = child.$on('abc', eventFn);
+        expect(log).toEqual('');
+        expect(listenerRemove).toBeDefined();
+
+        child.$emit('abc');
+        child.$broadcast('abc');
+        expect(log).toEqual('XX');
+
+        log = '';
+        listenerRemove();
+        child.$emit('abc');
+        child.$broadcast('abc');
+        expect(log).toEqual('');
+      });
+    });
+
+
+    describe('$emit', function() {
+      var log, child, grandChild, greatGrandChild;
+
+      function logger(event) {
+        log += event.currentScope.id + '>';
+      }
+
+      beforeEach(function() {
+        log = '';
+        child = root.$new();
+        grandChild = child.$new();
+        greatGrandChild = grandChild.$new();
+
+        root.id = 0;
+        child.id = 1;
+        grandChild.id = 2;
+        greatGrandChild.id = 3;
+
+        root.$on('myEvent', logger);
+        child.$on('myEvent', logger);
+        grandChild.$on('myEvent', logger);
+        greatGrandChild.$on('myEvent', logger);
+      });
+
+      it('should bubble event up to the root scope', function() {
+        grandChild.$emit('myEvent');
+        expect(log).toEqual('2>1>0>');
+      });
+
+
+      it('should dispatch exceptions to the $exceptionHandler', function() {
+        child.$on('myEvent', function() { throw 'bubbleException'; });
+        grandChild.$emit('myEvent');
+        expect(log).toEqual('2>1>0>');
+        expect(mockHandler.errors).toEqual(['bubbleException']);
+      });
+
+
+      it('should allow cancelation of event propagation', function() {
+        child.$on('myEvent', function(event){ event.cancel(); });
+        grandChild.$emit('myEvent');
+        expect(log).toEqual('2>1>');
+      });
+
+
+      it('should forward method arguments', function() {
+        child.$on('abc', function(event, arg1, arg2){
+          expect(event.name).toBe('abc');
+          expect(arg1).toBe('arg1');
+          expect(arg2).toBe('arg2');
+        });
+        child.$emit('abc', 'arg1', 'arg2');
+      });
+
+      describe('event object', function() {
+        it('should have methods/properties', function() {
+          var event;
+          child.$on('myEvent', function(e){
+            expect(e.targetScope).toBe(grandChild);
+            expect(e.currentScope).toBe(child);
+            expect(e.name).toBe('myEvent');
+            event = e;
+          });
+          grandChild.$emit('myEvent');
+          expect(event).toBeDefined();
+        });
+      });
+    });
+
+
+    describe('$broadcast', function() {
+      describe('event propagation', function() {
+        var log, child1, child2, child3, grandChild11, grandChild21, grandChild22, grandChild23,
+            greatGrandChild211;
+
+        function logger(event) {
+          log += event.currentScope.id + '>';
+        }
+
+        beforeEach(function() {
+          log = '';
+          child1 = root.$new();
+          child2 = root.$new();
+          child3 = root.$new();
+          grandChild11 = child1.$new();
+          grandChild21 = child2.$new();
+          grandChild22 = child2.$new();
+          grandChild23 = child2.$new();
+          greatGrandChild211 = grandChild21.$new();
+
+          root.id = 0;
+          child1.id = 1;
+          child2.id = 2;
+          child3.id = 3;
+          grandChild11.id = 11;
+          grandChild21.id = 21;
+          grandChild22.id = 22;
+          grandChild23.id = 23;
+          greatGrandChild211.id = 211;
+
+          root.$on('myEvent', logger);
+          child1.$on('myEvent', logger);
+          child2.$on('myEvent', logger);
+          child3.$on('myEvent', logger);
+          grandChild11.$on('myEvent', logger);
+          grandChild21.$on('myEvent', logger);
+          grandChild22.$on('myEvent', logger);
+          grandChild23.$on('myEvent', logger);
+          greatGrandChild211.$on('myEvent', logger);
+
+          //          R
+          //       /  |   \
+          //     1    2    3
+          //    /   / | \
+          //   11  21 22 23
+          //       |
+          //      211
+        });
+
+
+        it('should broadcast an event from the root scope', function() {
+          root.$broadcast('myEvent');
+          expect(log).toBe('0>1>11>2>21>211>22>23>3>');
+        });
+
+
+        it('should broadcast an event from a child scope', function() {
+          child2.$broadcast('myEvent');
+          expect(log).toBe('2>21>211>22>23>');
+        });
+
+
+        it('should broadcast an event from a leaf scope with a sibling', function() {
+          grandChild22.$broadcast('myEvent');
+          expect(log).toBe('22>');
+        });
+
+
+        it('should broadcast an event from a leaf scope without a sibling', function() {
+          grandChild23.$broadcast('myEvent');
+          expect(log).toBe('23>');
+        });
+
+
+        it('should not not fire any listeners for other events', function() {
+          root.$broadcast('fooEvent');
+          expect(log).toBe('');
+        });
+      });
+
+
+      describe('listener', function() {
+        it('should receive event object', function() {
+          var scope = angular.scope(),
+              child = scope.$new(),
+              event;
+
+          child.$on('fooEvent', function(e) {
+            event = e;
+          });
+          scope.$broadcast('fooEvent');
+
+          expect(event.name).toBe('fooEvent');
+          expect(event.targetScope).toBe(scope);
+          expect(event.currentScope).toBe(child);
+        });
+
+
+        it('should support passing messages as varargs', function() {
+          var scope = angular.scope(),
+              child = scope.$new(),
+              args;
+
+          child.$on('fooEvent', function() {
+            args = arguments;
+          });
+          scope.$broadcast('fooEvent', 'do', 're', 'me', 'fa');
+
+          expect(args.length).toBe(5);
+          expect(sliceArgs(args, 1)).toEqual(['do', 're', 'me', 'fa']);
+        });
+      });
+    });
+  });
+});