Improve this Doc View Source angular.forEach

From Get docs
< Function components in ngAngularjs/docs/1.8/api/ng/function/angular.foreach


Improve this Doc View Source angular.forEach

  1. function in module ng

Overview

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–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
https://code.angularjs.org/1.8.2/docs/api/ng/function/angular.forEach