Array.prototype.map
Создаёт новый массив, преобразуя каждый элемент.
Доступно с: ES5
Синтаксис
array.map(callbackFn)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| callbackFn | Function | Функция, которая получает элемент, его индекс и весь массив и возвращает новое значение. |
Возвращаемое значение
ArrayНовый массив той же длины с результатами вызова функции.
Примеры
Удвоение каждого числа:
console.log([1, 2, 3].map((n) => n * 2).join(', '));Результат:
2, 4, 6Одно свойство из каждого объекта:
const users = [{ name: 'Anna' }, { name: 'Oleg' }];
console.log(users.map((user) => user.name).join(', '));Результат:
Anna, OlegПримечания
Исходный массив не меняется. Если результат не нужен, а нужно просто выполнить действие для каждого элемента, используйте forEach().
См. также
- Array.prototype.filter — Создаёт новый массив из элементов, прошедших проверку.
- Array.prototype.forEach — Выполняет функцию для каждого элемента массива.
- Array.prototype.flatMap — Применяет функцию к каждому элементу и раскрывает результат на один уровень.
- Array.from — Создаёт массив из строки, Set, Map или другого перебираемого объекта.
Вопросы и ответы по теме
В учебнике
- map, filter и reduce — Три главных метода обработки массивов в JavaScript: преобразование, отбор и сведение к одному значению.