Метод map()

Array.map()

Создаёт новый массив с результатом вызова указанной функции для каждого элемента массива.

Синтаксис

array.map(function callback(currentValue, index, arr), thisValue)

Параметры

searchElement

Функция обратного вызова, которая будет выполнена один раз для каждого элемента в массиве, принимает три аргумента:

• currentValue – значение текущего элемента
• index – индекс массива текущего элемента.
• arr – массив, к которому принадлежит текущий элемент (по которому происходит проход).

thisValue

Необязательный параметр. Объект, на который может ссылаться ключевое слово this внутри функции обратного вызова. Если параметр thisValue не используется, то в качестве значения this будет использоваться undefined (в конечном итоге, значение this, наблюдаемое из функции callback, определяется согласно обычным правилам определения this, видимого из функции).

Возвращаемое значение

Новый массив, в котором каждый элемент является возвращаемым значением функции обратного вызова для связанного исходного элемента массива.

Описание

Метод map() позволяет вызвать переданную функцию один раз для каждого элемента массива, формируя новый массив из результатов вызова этой функции.

Диапазон элементов, обрабатываемых с помощью метода map() устанавливается перед первым вызовом функции обратного вызова. Если элементы были добавлены к массиву после её вызова, то на таких элементах функция вызвана не будет.

Если существующие элементы массива изменяются функцией callback, их значения, переданные в функцию, будут значениями на тот момент времени, когда метод map() посетит их. Удалённые элементы посещены не будут. Если значения существующих элементов массива изменяются в момент выполнения, то в качестве передаваемого значения функции будет значение в тот момент времени, когда метод map() посещает их. Если элементы удаляются до их посещения, то такие элементы посещены не будут.

Следующий код берёт массив чисел и создаёт новый массив, содержащий элементы первого массива увеличенные в два раза:

Примеры

В следующем примере используется второй аргумент метода map(), который указывает на объект, на который может ссылаться ключевое слово this внутри функции обратного вызова: