Метод JavaScript Array map () створює новий масив з результатами виклику функції для кожного елемента масиву.
Синтаксис map()
методу:
arr.map(callback(currentValue), thisArg)
Тут arr - це масив.
Параметри map ()
map()
Метод приймає в:
- callback - функція, що викликається для кожного елемента масиву. Його повернені значення додаються до нового масиву. Це приймає:
- currentValue - поточний елемент, що передається з масиву.
- thisArg (необов’язково) - значення, яке використовується як
this
при виконанні зворотного виклику. За замовчуванням це такundefined
.
Повернути значення з карти ()
- Повертає новий масив з елементами як значеннями повернення від
callback
функції для кожного елемента.
Примітки :
map()
не змінює вихідний масив.map()
виконуєтьсяcallback
один раз для кожного елементу масиву по порядку.map()
не виконуєтьсяcallback
для елементів масиву без значень.
Приклад 1: Зіставлення елементів масиву за допомогою користувацької функції
const prices = (1800, 2000, 3000, 5000, 500, 8000); let newPrices = prices.map(Math.sqrt); // ( 42.42640687119285, 44.721359549995796, 54.772255750516614, // 70.71067811865476, 22.360679774997898, 89.44271909999159 ) console.log(newPrices); // custom arrow function const string = "JavaScript"; const stringArr = string.split(''); // array with individual string character let asciiArr = stringArr.map(x => x.charCodeAt(0)); // map() does not change the original array console.log(stringArr); // ('J', 'a', 'v', 'a','S', 'c', 'r', 'i', 'p', 't') console.log(asciiArr); // ( 74, 97, 118, 97, 83, 99, 114, 105, 112, 116 )
Вихідні дані
(42.42640687119285, 44.721359549995796, 54.772255750516614, 70.71067811865476, 22.360679774997898, 89.44271909999159) ('J', 'a', 'v', 'a', 'S', 'c', 'r' 't') (74, 97, 118, 97, 83, 99, 114, 105, 112, 116)
Приклад 2: map () для об'єктних елементів у масиві
const employees = ( ( name: "Adam", salary: 5000, bonus: 500, tax: 1000 ), ( name: "Noah", salary: 8000, bonus: 1500, tax: 2500 ), ( name: "Fabiano", salary: 1500, bonus: 500, tax: 200 ), ( name: "Alireza", salary: 4500, bonus: 1000, tax: 900 ), ); // calculate the net amout to be given to the employees const calcAmt = (obj) => ( newObj = (); newObj.name = obj.name; newObj.netEarning = obj.salary + obj.bonus - obj.tax; return newObj; ); let newArr = employees.map(calcAmt); console.log(newArr);
Вихідні дані
((ім'я: 'Адам', netEarning: 4500), (ім'я: 'Ной', netEarning: 7000), (ім'я: 'Фабіано', netEarning: 1800), (ім'я: 'Аліреза', netEarning: 4600))
Примітка : map()
присвоює undefined
новому масиву, якщо callback
функція повертає undefined
або нічого.
Рекомендована література: Фільтр масиву JavaScript ()