.map()
Published Jun 21, 2021Updated Oct 4, 2021
Contribute to Docs
Creates a new array with the results of calling a function for every element in array.
Syntax
array.map((element, index, array) => {...});
The callback function accepts the following parameters:
element
(required): The current element we are iterating through.index
(optional): The index of the current element we are iterating through.array
(optional): The array thatmap()
was called on.
Examples
Create a new array which doubles the values in numbers
:
const numbers = [1, 2, 3, 4, 5];const doubled = numbers.map((value) => value * 2);console.log(doubled);// Output: [2, 4, 6, 8, 10]
Create an array of full names from the students
array full of objects:
const students = [{ first_name: 'Samantha', last_name: 'Jones' },{ first_name: 'Hector', last_name: 'Gonzales' },{ first_name: 'Jeremiah', last_name: 'Duncan' },];const fullNames = students.map((student) => {return `${student.first_name} ${student.last_name}`;});console.log(fullNames);// Output: ['Samantha Jones', 'Hector Gonzales', 'Jeremiah Duncan']
All contributors
Looking to contribute?
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.