Iterator.prototype.map()

Iterator.prototype.map() создаёт новый итератор, значения которого это результат преобразования элементов исходного итератора с помощью колбэк-функции. Колбэк-функция вызывается только при запросе значения у нового итератора, например при вызове метода next(). О том, что такое итератор, можно прочитать в статье «Итератор».

Представим, что у нас есть итератор по станциям Лондонского метро 🚇:

        
          
          // Итератор по массивуconst iterator = [  { title: "Green Park", opened: 1906, connections: 2 },  { title: "Bond Street", opened: 1900, connections: 2 },  { title: "Baker Street", opened: 1863, connections: 4 },  { title: "St. John's Wood", opened: 1939, connections: 0 } // Abbey Road is nearby!].values()
          // Итератор по массиву
const iterator = [
  { title: "Green Park", opened: 1906, connections: 2 },
  { title: "Bond Street", opened: 1900, connections: 2 },
  { title: "Baker Street", opened: 1863, connections: 4 },
  { title: "St. John's Wood", opened: 1939, connections: 0 } // Abbey Road is nearby!
].values()

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Необходимо получить итератор, содержащий информацию о станциях в виде строк:

        
          
          // Создаём итератор по названиям станцийconst titleIterator = iterator.map((station) => {    return `Станция ${station.title} работает с ${station.opened} г.`})// Получаем значенияconsole.log(titleIterator.toArray())// [//  "Станция Green Park работает с 1906 г.",//  "Станция Bond Street работает с 1900 г.",//  "Станция Baker Street работает с 1863 г.",//  "Станция St. John's Wood работает с 1939 г."// ]
          // Создаём итератор по названиям станций
const titleIterator = iterator.map((station) => {
    return `Станция ${station.title} работает с ${station.opened} г.`
})

// Получаем значения
console.log(titleIterator.toArray())
// [
//  "Станция Green Park работает с 1906 г.",
//  "Станция Bond Street работает с 1900 г.",
//  "Станция Baker Street работает с 1863 г.",
//  "Станция St. John's Wood работает с 1939 г."
// ]

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Iterator.prototype.map() принимает один обязательный аргумент — колбэк-функцию.

Колбэк-функция вызывается только в случае запроса данных и возвращает текущее значение нового итератора.

При вызове колбэк-функция получает аргументы:

• element — текущее значение исходного итератора;
• index — индекс значения.

Если попытаться выполнить Iterator.prototype.map() без аргумента или передать не функцию, будет брошена ошибка TypeError.

Iterator.prototype.map() возвращает новый итератор.

Метод Iterator.prototype.map() не стоит путать с методом массива Array.prototype.map(). Оба метода выполняют преобразования элементов коллекции с помощью колбэк-функции, но делают это по-разному.

Для массивов создание новой коллекции происходит в момент вызова метода map().

Итераторы используют «ленивые» вычисления (lazy evaluation): преобразование текущего элемента исходного итератора выполняется только по мере необходимости (при запросе значения нового итератора). Это позволяет экономить память, избегать лишних операций и работать с бесконечными потоками данных.

Рассмотрим, как можно выполнять преобразование данных, полученных из генератора.

У нас есть функция-генератор случайных событий:

        
          
          function* eventGenerator() {  const eventTypes = ['info', 'warn', 'error', 'debug'];  let id = 0;  while (true) {    const randomIndex = Math.floor(Math.random() * eventTypes.length)    const type = eventTypes[randomIndex];    yield { id: id++, type, message: `Событие ${id}: ${type.toUpperCase()}` }  }}
          function* eventGenerator() {
  const eventTypes = ['info', 'warn', 'error', 'debug'];
  let id = 0;
  while (true) {
    const randomIndex = Math.floor(Math.random() * eventTypes.length)
    const type = eventTypes[randomIndex];
    yield { id: id++, type, message: `Событие ${id}: ${type.toUpperCase()}` }
  }
}

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Создадим генератор и получим несколько случайных значений:

        
          
          const events = eventGenerator()console.log(events.next().value)// { id: 0, type: 'warn', message: 'Событие 1: WARN' }console.log(events.next().value)// { id: 1, type: 'debug', message: 'Событие 2: DEBUG' }
          const events = eventGenerator()

console.log(events.next().value)
// { id: 0, type: 'warn', message: 'Событие 1: WARN' }
console.log(events.next().value)
// { id: 1, type: 'debug', message: 'Событие 2: DEBUG' }

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

events является итерируемым объектом, но не имеет конечного состояния ({ done: true }) и поэтому это «бесконечный» итератор. Как быть, если необходимо преобразовать его значения без изменения исходной функции-генератора?

Создадим новый итератор на основе events с помощью метода map():

        
          
          const eventTypes = events.map(item => item.type)console.log(eventTypes.next().value)// errorconsole.log(eventTypes.next().value)// info
          const eventTypes = events.map(item => item.type)

console.log(eventTypes.next().value)
// error
console.log(eventTypes.next().value)
// info

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

Итератор, созданный методом Iterator.prototype.map(), использует исходный итератор как источник данных и разделяет с ним состояние (указатель на текущее значение). Если вызвать next() на одном из итераторов, указатель сдвинется для обоих:

        
          
          const days = ['пн', 'вт', 'ср', 'чт', 'пт'].values()// Создаём итератор с преобразованием строки в объект:const transformedDays = days.map((item) => {  return { day: item }})// Первое значение исходного итератораconsole.log(days.next().value)// пн// Следующее доступное значение исходного итератора — 'вт'// Значение нового итератора — результат его преобразования:console.log(transformedDays.next().value)// { day: 'вт' }// Следующее доступное значение исходного итератора — 'ср'console.log(days.next().value)// ср
          const days = ['пн', 'вт', 'ср', 'чт', 'пт'].values()

// Создаём итератор с преобразованием строки в объект:
const transformedDays = days.map((item) => {
  return { day: item }
})

// Первое значение исходного итератора
console.log(days.next().value)
// пн

// Следующее доступное значение исходного итератора — 'вт'
// Значение нового итератора — результат его преобразования:
console.log(transformedDays.next().value)
// { day: 'вт' }

// Следующее доступное значение исходного итератора — 'ср'
console.log(days.next().value)
// ср

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

До сих пор мы использовали в колбэк-функции только текущее значение исходного итератора. Посмотрим на второй параметр — индекс элемента:

        
          
          // Исходный итераторconst birds = ['🦆', '🦢', '🦉', '🦜'].values()// Создаём итератор с преобразованием значенийconst transformed = birds.map((item, index) => {  return `Значение:${item}, индекс: ${index}`})console.log(birds.next().value)// 🦆console.log(transformed.next().value)// Значение:🦢, индекс: 0console.log(birds.next().value)// 🦉console.log(transformed.next().value)// Значение:🦜, индекс: 1
          // Исходный итератор
const birds = ['🦆', '🦢', '🦉', '🦜'].values()

// Создаём итератор с преобразованием значений
const transformed = birds.map((item, index) => {
  return `Значение:${item}, индекс: ${index}`
})

console.log(birds.next().value)
// 🦆
console.log(transformed.next().value)
// Значение:🦢, индекс: 0
console.log(birds.next().value)
// 🦉
console.log(transformed.next().value)
// Значение:🦜, индекс: 1

        
        
          
            
            Скопировать
            Скопировано
            Не удалось скопировать
          
        
      

index — это порядковый номер вызова колбэк-функции, а не индекс значения в исходном итераторе. Сдвиг указателя на исходном итераторе влияет на то, какое значение будет обработано, но не влияет на index в колбэке.

Поддержка map() как и других helper-методов появилась в Node.js начиная с версии 22.