Гайды

Ошибка «is not a function» — почему она появляется и как её починить

Иллюстрация: рука жмёт на кнопку, нарисованную на стене, а настоящий рычаг — рядом

Приложение падает, в консоли красная строка:

TypeError: data.map is not a function

Первая мысль — «но .map же существует, я сто раз его видел». Всё верно, существует. Просто не у той штуки, к которой ты его применил.

Смотри, в чём суть этой ошибки. Ты пытаешься нажать кнопку, а она оказалась нарисованной на стене. Программа дошла до data.map(...), заглянула в data.map — а там не функция. Там undefined или что-то совсем другое. Вызвать такое нельзя.

Как прочитать эту ошибку

Сообщение всегда устроено одинаково: что ты пытался вызвать + is not a function.

  • data.map is not a function — проблема в data: у него нет метода map.
  • getUser is not a function — проблема в самом getUser: в этом месте это не функция.
  • this.props.onSave is not a function — не пришло то, что должно было прийти.

Ниже в ошибке будет номер строки — туда и смотри. Как разбирать сообщения об ошибках целиком, рассказано в статье как читать сообщение об ошибке.

Дальше — три причины. Начинай с первой: она случается чаще остальных, вместе взятых.

Причина 1: значение не того типа

Самый частый случай. Ты думаешь, что в data лежит массив. А сервер прислал объект, у которого массив внутри:

// ты ждал:  [ {...}, {...} ]
// пришло:   { items: [ {...}, {...} ], total: 2 }
data.map(...)   // у объекта нет map → ошибка

У массива есть map, filter, forEach. У объекта — нет. Разница подробно разобрана в статье массив или объект.

Как проверить. Прямо перед строкой с ошибкой добавь:

console.log(typeof data, Array.isArray(data), data)

Если увидишь object false — перед тобой объект, а не массив. Если undefined — данные ещё не пришли или пришли пустыми.

Как починить. Достань массив оттуда, где он на самом деле лежит: data.items.map(...). А если данных может не быть — подстрахуйся: (data?.items ?? []).map(...). Этот хвост значит «если пусто — возьми пустой список».

Вся эта история — частный случай спора о типах. Про него целиком — в статье что такое тип данных.

Причина 2: такого метода нет

Второй вариант — метод просто не существует. Опечатка, метод из другого языка или выдумка ИИ.

Классика — contains:

"привет мир".contains("мир")   // TypeError: ... is not a function
"привет мир".includes("мир")   // true — вот так правильно

В Java и C# метод называется contains, а в JavaScript — includes. Модели учились на всех языках сразу и иногда путают. Это одна из типичных причин, почему в коде от ИИ бывают баги.

Как проверить. Найди метод в документации. Для JavaScript — MDN: набери в поиске «mdn String includes». Если метода с таким именем там нет — его не существует.

Как починить. Замени на настоящий метод. Или попроси ИИ, но с конкретикой: «метода contains у строк в JavaScript нет — замени на существующий и проверь остальные методы в этом файле по MDN».

Причина 3: импорт достал не то

Функция существует, лежит в соседнем файле — а в твоём файле её нет. Чаще всего путаются фигурные скобки:

// в файле api.js:
export function getUser() { ... }

// в твоём файле:
import getUser from "./api"     // ❌ ищет экспорт по умолчанию — его нет
import { getUser } from "./api" // ✅ берёт функцию по имени

Без скобок импорт ищет «главный» экспорт файла (export default). Если такого нет, в getUser окажется undefined. И при вызове — та самая ошибка.

Как проверить. Открой файл, откуда импортируешь, и посмотри, как написан экспорт. Есть слово default — импортируй без скобок. Нет — со скобками и тем же именем.

Как починить. Приведи импорт в соответствие с экспортом. Одна пара скобок — и всё заработало.

Если ничего не помогло

Есть редкая четвёртая причина: имя перезаписали. Например, завели переменную с тем же именем, что у функции: let total = total(). Поищи по файлу, не объявлено ли это имя дважды.

А чтобы ИИ помог точно, дай ему всё сразу:

Слабый промптОшибка is not a function, почини
Сильный промптПриложение падает с ошибкой: TypeError: data.map is not a function, строка 42 в OrderList.jsx. Перед этой строкой console.log(typeof data, data) выводит: object и объект с полями items и total. Найди, откуда приходит data, и исправь код так, чтобы map вызывался у массива. Если данных нет — показывай пустой список.

Почему ошибка появляется не сразу, а иногда?

Потому что данные бывают разными. Сервер иногда возвращает пустой ответ или ошибку вместо списка. Тогда data оказывается undefined — и код падает только в этих случаях.

Это ошибка в моём коде или в библиотеке?

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

Как не получать эту ошибку в будущем?

Помогает TypeScript: он заранее подсветит вызов несуществующего метода, ещё до запуска. И привычка проверять, что именно пришло с сервера.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →