fix(forEach): add the array/object as the 3rd param like the native array forEach

Author: jbedard

src/Angular.js

@@ -208,9 +208,9 @@ function isArrayLike(obj) {
  *
  * @description
  * Invokes the `iterator` function once for each item in `obj` collection, which can be either an
- * object or an array. The `iterator` function is invoked with `iterator(value, key)`, where `value`
- * is the value of an object property or an array element and `key` is the object property key or
- * array element index. Specifying a `context` for the function is optional.
+ * object or an array. The `iterator` function is invoked with `iterator(value, key, obj)`, where `value`
+ * is the value of an object property or an array element, `key` is the object property key or
+ * array element index and obj is the `obj` itself. Specifying a `context` for the function is optional.
  *
  * It is worth noting that `.forEach` does not iterate over inherited properties because it filters
  * using the `hasOwnProperty` method.
@@ -238,19 +238,19 @@ function forEach(obj, iterator, context) {
         // Need to check if hasOwnProperty exists,
         // as on IE8 the result of querySelectorAll is an object without a hasOwnProperty function
         if (key != 'prototype' && key != 'length' && key != 'name' && (!obj.hasOwnProperty || obj.hasOwnProperty(key))) {
-          iterator.call(context, obj[key], key);
+          iterator.call(context, obj[key], key, obj);
         }
       }
     } else if (obj.forEach && obj.forEach !== forEach) {
       obj.forEach(iterator, context);
     } else if (isArrayLike(obj)) {
       for (key = 0, length = obj.length; key < length; key++) {
-        iterator.call(context, obj[key], key);
+        iterator.call(context, obj[key], key, obj);
       }
     } else {
       for (key in obj) {
         if (obj.hasOwnProperty(key)) {
-          iterator.call(context, obj[key], key);
+          iterator.call(context, obj[key], key, obj);
         }
       }
     }

test/AngularSpec.js

@@ -617,6 +617,51 @@ describe('angular', function() {
       forEach(obj, function(value, key) { log.push(key + ':' + value); });
       expect(log).toEqual(['length:2', 'foo:bar']);
     });
+
+    function testForEachSpec(expectedSize, collection) {
+      var that = {};
+
+      forEach(collection, function(value, key, collectionArg) {
+        expect(collectionArg).toBe(collection);
+        expect(collectionArg[key]).toBe(value);
+
+        expect(this).toBe(that);
+
+        expectedSize--;
+      }, that);
+
+      expect(expectedSize).toBe(0);
+    }
+    it('should follow spec with array', function() {
+      testForEachSpec(2, [1,2]);
+    });
+    it('should follow spec with arguments', function() {
+      testForEachSpec(2, (function(){ return arguments; }(1,2)));
+    });
+    it('should follow spec with string', function() {
+      testForEachSpec(2, '12');
+    });
+    it('should follow spec with jQuery/jqLite', function() {
+      testForEachSpec(2, jqLite("<span>a</span><span>b</span>"));
+    });
+    it('should follow spec with childNodes NodeList', function() {
+      testForEachSpec(2, jqLite("<p><span>a</span><span>b</span></p>")[0].childNodes);
+    });
+    it('should follow spec with getElementsByTagName HTMLCollection', function() {
+      testForEachSpec(2, jqLite("<p><span>a</span><span>b</span></p>")[0].getElementsByTagName("*"));
+    });
+    it('should follow spec with querySelectorAll HTMLCollection', function() {
+      testForEachSpec(2, jqLite("<p><span>a</span><span>b</span></p>")[0].querySelectorAll("*"));
+    });
+    it('should follow spec with JSON', function() {
+      testForEachSpec(2, {a: 1, b: 2});
+    });
+    it('should follow spec with function', function() {
+      function f(){}
+      f.a = 1;
+      f.b = 2;
+      testForEachSpec(2, f);
+    });
   });