W3cubDocs

/Angular.js 1.4

Improve this Doc View Source angular.forEach

  1. function in module ng

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, 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.

Unlike ES262's Array.prototype.forEach, providing 'undefined' or 'null' values for obj will not throw a TypeError, but rather just return the value provided.

var values = {name: 'misko', gender: 'male'};
var log = [];
angular.forEach(values, function(value, key) {
  this.push(key + ': ' + value);
}, log);
expect(log).toEqual(['name: misko', 'gender: male']);

Usage

angular.forEach(obj, iterator, [context]);

Arguments

Param Type Details
obj ObjectArray

Object to iterate over.

iterator Function

Iterator function.

context
(optional)
Object

Object to become context (this) for the iterator function.

Returns

ObjectArray

Reference to obj.

© 2010–2016 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.4.14/docs/api/ng/function/angular.forEach