Iterator.prototype.map()

Метод map() экземпляров Iterator возвращает новый объект-помощник итератора, который генерирует элементы итератора, каждый из которых преобразован функцией отображения.

Синтаксис

map(callbackFn)

Параметры

callbackFn

Функция для выполнения для каждого элемента, сгенерированного итератором. Её возвращаемое значение генерируется помощником итератора. Функция вызывается со следующими аргументами:

element

Текущий обрабатываемый элемент.

index

Индекс текущего обрабатываемого элемента.

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

Новый объект-помощник итератора. Каждый раз, когда метод next() помощника итератора вызывается, он получает следующий элемент из базового итератора, применяет callbackFn и генерирует возвращаемое значение. Когда базовый итератор завершен, помощник итератора также завершается (метод next() генерирует { value: undefined, done: true }).

Описание

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

Примеры

Использование map()

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

function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

const seq = fibonacci().map((x) => x ** 2);
console.log(seq.next().value); // 1
console.log(seq.next().value); // 1
console.log(seq.next().value); // 4

Использование map() с циклом for...of

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

for (const n of fibonacci().map((x) => x ** 2)) {
  console.log(n);
  if (n > 30) {
    break;
  }
}

// Logs:
// 1
// 1
// 4
// 9
// 25
// 64

Это эквивалентно:

for (const n of fibonacci()) {
  const n2 = n ** 2;
  console.log(n2);
  if (n2 > 30) {
    break;
  }
}

Спецификации

Совместимость с браузерами

Смотрите также

• Полифилл для Iterator.prototype.map в core-js
• Полифилл es-shims для Iterator.prototype.map
• Iterator
• Iterator.prototype.flatMap()
• Array.prototype.reduce()