介绍：Lodash 的 _.forEach

Lodash 是 JavaScript 中使用广泛的一个实用工具库。其中的 .forEach 是一个非常有用的函数，用于循环一个集合并为每个元素执行一个函数。在开发过程中，尤其是遍历数组和对象时，.forEach 函数能够大大提高代码的可读性和可维护性。

语法

_.forEach(collection, [iteratee=_.identity])

• collection (Array|Object|string)： 需要迭代的集合。
• [iteratee=_.identity] (Function)：每个元素需要执行的函数。

返回值

函数没有返回值，仅仅是为了遍历集合并执行 iteratee 函数。如果想在遍历中得到某些值，一般使用 _.map 或 _.reduce 函数。

注意点

1. 如果要停止循环，可以在 iteratee 函数中使用任何 JavaScript 能够使用的方法，比如使用 break 或者 return false。
2. 在对对象进行遍历时，iteratee 函数的参数为 (value, key, collection)。

示例

const _ = require('lodash');

const arr = [1, 2, 3, 4, 5];

_.forEach(arr, (value, index) => {
  console.log(`第 ${index + 1} 个元素是 ${value}`);
  if (value === 3) {
    console.log('现在停止循环');
    return false;
  }
});

/*
  输出：
    第 1 个元素是 1
    第 2 个元素是 2
    第 3 个元素是 3
    现在停止循环
*/

const object = { a: 1, b: 2, c: 3 };

_.forEach(object, (value, key) => {
  console.log(`键 ${key} 的值是 ${value}`);
});

/*
  输出：
    键 a 的值是 1
    键 b 的值是 2
    键 c 的值是 3
*/

Lodash 的 _.stopForEach

如果在 Lodash 的 _.forEach 函数中，想要停止循环并返回一个值，那需要写很多额外的代码，比如设置循环的变量、在循环中返回值等。这些操作可能会导致代码的可读性和可维护性变得很差。

因此，这里介绍一个自定义 Lodash 函数 _.stopForEach，它能够在循环中停止并返回一个值。

代码实现

_.stopForEach = function (collection, iteratee) {
  let result;
  _.forEach(collection, (value, key, collection) => {
    result = iteratee(value, key, collection);
    if (result === false) {
      return false;
    }
  });
  return result;
};

语法

_.stopForEach(collection, iteratee);

• collection (Array|Object|string)： 需要迭代的集合。
• iteratee (Function)：每个元素需要执行的函数。

返回值

如果在循环中 iteratee 函数执行了 return，那么 _.stopForEach 函数将返回 return 后面的值。否则，将返回 undefined。

示例

const _ = require('lodash');

const arr = [1, 2, 3, 4, 5];

const result = _.stopForEach(arr, (value, index) => {
  console.log(`第 ${index + 1} 个元素是 ${value}`);
  if (value === 3) {
    console.log('现在停止循环');
    return '停止循环并返回这个字符串';
  }
});
console.log(result);

/*
  输出：
    第 1 个元素是 1
    第 2 个元素是 2
    第 3 个元素是 3
    现在停止循环
    停止循环并返回这个字符串
*/

const object = { a: 1, b: 2, c: 3 };

const value = _.stopForEach(object, (value, key) => {
  console.log(`键 ${key} 的值是 ${value}`);
  if (value === 2) {
    console.log('现在停止循环');
    return false;
  }
});
console.log(value);

/*
  输出：
    键 a 的值是 1
    键 b 的值是 2
    现在停止循环
    false
*/

可以发现，在使用 _.stopForEach 函数后，我们可以通过简单的代码实现停止循环并返回值的功能，避免了写过多的额外代码。