Ошибка «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 коротких урока на телефоне.





