/**
 * @function Array.prototype.forEach
 * @description 循环遍历数组每个元素执行执行一次给定的函数，除了抛出异常无法终止或跳出循环，不会改变原数组
 * @description for VS forEach：1.forEach是不能被break打断的，执行break会报错,for循环可以被break打断；2.forEach没有返回值return,for循环内执行return语句会报错
 * @param callback callback三个参数：1.当前值。2.当前索引（可选）3.当前数组（可选）
 * @param thisArg 可选参数，callback被调用时，this都会指向thisArg参数，不指定时this指向全局对象
 */
Array.prototype.forEach = function (callback, thisArg) {
  // null | undefined 不能调用方法
  if ((!this && typeof this === 'object') || typeof this === 'undefined') {
    throw new Error(`Uncaught TypeError: Cannot read properties of ${this}`);
  };
  if (typeof callback !== 'function') {
    throw new Error(`${callback} is not a function`);
  }
  // 获取数组
  const arr = Object(this);
  const _len = arr.length;
  for (let i = 0; i < _len; i++) {
    callback.call(thisArg || this, arr[i], i, arr);
  }
}


/**
 * @function Array.prototype.map
 * @description 循环遍历数组每个元素执行执行一次给定的函数，返回执行结果，不改变原数组
 * @param callback callback三个参数：1.当前值。2.当前索引（可选）3.当前数组（可选）
 * @param thisArg 可选参数，callback被调用时，this都会指向thisArg参数，不指定时this指向全局对象
 */
Array.prototype.map = function (callback: { call: (arg0: any, arg1: number, arg2: any[]) => any; }) {
  // null | undefined 不能调用方法
  if ((!this && typeof this === 'object') || typeof this === 'undefined') {
    throw new Error(`Uncaught TypeError: Cannot read properties of ${this}`)
  };
  if (typeof callback !== 'function') {
    throw new Error(`${callback} is not a function`)
  }
  // 获取数组
  const arr = Object(this);
  const _len = arr.length;
  let result = [];
  for (let i = 0; i < _len; i++) {
    const newItem = callback(arr[i], i, arr)
    result.push(newItem);
  }
  return result;
}

// test data
const forArr = [1, 2, 3, 4, 5];
const forResult = forArr.forEach(item => item + 1);
console.log(`forEach执行后原数组为${forArr}`);
console.log(`forEach执行后返回的执行结果为${forResult}`);

const newMapArr = forArr.map(item => item + 3);
console.log(`map执行后原数组为${forArr}`);
console.log(`map执行后返回的结果为${newMapArr}`);