Сколько аргументов передается в map?

Развернутый ответ на вопрос об аргументах метода map()

Метод Array.prototype.map() в JavaScript принимает до трёх аргументов в callback-функции, которая выполняется для каждого элемента массива. Давайте детально разберем каждый из них.

Сигнатура метода map()

array.map(callback(currentValue, index, array), thisArg)

Здесь:

• callback — функция, вызываемая для каждого элемента массива. Именно эта функция получает три аргумента.
• thisArg (опционально) — значение, используемое как this при выполнении callback-функции.

Три аргумента callback-функции

1. currentValue (обязательный в большинстве случаев)

Текущий элемент массива, который обрабатывается в данной итерации. Это основной аргумент, ради которого обычно используют map().

2. index (опционально)

Индекс (порядковый номер) текущего элемента в массиве. Нумерация начинается с 0.

3. array (опционально)

Ссылка на исходный массив, который обрабатывается методом map(). Полезно, если нужно обратиться к оригинальному массиву внутри callback-функции.

Пример использования всех трёх аргументов

const numbers = [10, 20, 30];

const result = numbers.map(function(currentValue, index, array) {
  console.log(`Элемент ${currentValue} имеет индекс ${index}`);
  console.log(`Полный массив: [${array}]`);
  
  // Можно использовать все три аргумента для вычислений
  return currentValue * index + array.length;
});

console.log(result); // [0, 21, 62]

Особенности и нюансы

Необязательность аргументов

Вы можете использовать только те аргументы, которые действительно нужны:

// Используем только первый аргумент
const doubled = [1, 2, 3].map(x => x * 2);

// Используем первый и второй аргументы
const withIndices = [10, 20, 30].map((value, index) => `${index}: ${value}`);

// Используем все три аргумента
const complex = [5, 6, 7].map((value, index, arr) => value + index + arr.length);

Стрелочные функции и контекст this

При использовании стрелочных функций аргумент thisArg игнорируется, так как стрелочные функции не имеют своего this:

const data = [1, 2, 3];
const multiplier = { factor: 10 };

// С обычной функцией - thisArg работает
const result1 = data.map(function(value) {
  return value * this.factor;
}, multiplier); // [10, 20, 30]

// Со стрелочной функцией - thisArg игнорируется
const result2 = data.map(value => value * this.factor, multiplier); // [NaN, NaN, NaN]

Использование аргумента array

Третий аргумент может быть полезен в специфических сценариях:

// Пример: сравнение с соседними элементами
const temperatures = [22, 24, 19, 25, 18];
const changes = temperatures.map((current, index, arr) => {
  const prev = arr[index - 1] || null;
  const next = arr[index + 1] || null;
  return { current, prev, next };
});

Практическое применение разных аргументов

Использование индекса для создания уникальных ключей

const users = ['Анна', 'Борис', 'Мария'];
const userList = users.map((name, index) => ({
  id: `user_${index + 1}`,
  name,
  position: index + 1
}));

Использование ссылки на исходный массив

// Нормализация данных относительно максимального значения
const scores = [85, 92, 78, 95, 88];
const normalized = scores.map((score, _, arr) => {
  const maxScore = Math.max(...arr);
  return (score / maxScore) * 100;
});

Важные замечания

1. Порядок аргументов фиксирован — сначала значение, затем индекс, затем массив.
2. Callback-функция вызывается только для существующих элементов массива — пропускаются пустые ячейки разреженных массивов.
3. map() не изменяет исходный массив, а возвращает новый.
4. Вы можете использовать меньше трёх аргументов, но не можете изменить их порядок.

Сравнение с другими методами итерации

Интересно, что такая же сигнатура с тремя аргументами используется и в других методах массивов: forEach(), filter(), reduce() (у reduce дополнительный аргумент — аккумулятор). Это обеспечивает консистентность API JavaScript.

Заключение

Таким образом, callback-функция в методе map() принимает три аргумента: текущий элемент, его индекс и ссылку на исходный массив. При этом вы можете использовать от одного до трёх аргументов в зависимости от решаемой задачи. Понимание всех трёх параметров позволяет писать более выразительный и мощный код для трансформации данных в JavaScript.