x is not a function

Определение и применение

TypeError — код пытается вызвать как функцию значение, которое функцией не является: undefined, строку, число или обычный объект.

Объяснение на задачах — в уроке учебника «Консоль браузера и ошибки».

Частые причины

  • Опечатка в имени метода: list.lenght(), str.toUppercase().
  • Метод у другого типа: "чай".map(), querySelectorAll(...).map() — у NodeList нет map.
  • Переменную с функцией перезаписали значением.
  • Функциональное выражение var f = … вызвано выше объявления.
  • Callback не передали: run() вызывает callback(), а аргумента нет.
  • Пропущена точка с запятой: строка, начинающаяся со скобки, склеилась с предыдущей.

Как исправить

Выведите typeof выражения перед вызовом и проверьте имя метода в справочнике. Коллекцию элементов превращайте в массив Array.from(list). Необязательный callback можно вызвать через callback?.(), только если допустимы функция, null или undefined. Невызываемые 0, строка или объект всё равно дадут TypeError; если тип неизвестен, проверьте typeof callback === "function".

Сообщения в браузерах

Примеры сообщений. Имена и подробности зависят от кода и версии браузера.

x is not a function в разных браузерах
Браузер Сообщение
Chrome и Edge (V8) TypeError: title.map is not a function
Firefox TypeError: title.map is not a function
Safari (JavaScriptCore) TypeError: title.map is not a function. (In 'title.map((char) => char.toUpperCase())', 'title.map' is undefined)

В примерах ниже указан вывод Chromium.

Правильное имя само по себе не делает свойство методом: length у строки и массива читают без скобок. Запись list.length() всё равно пытается вызвать число.

Примеры

Метод не того типа

Вывод: TypeError: title.map is not a function, затем ["Ч","А","Й"] — строка сначала превращена в массив.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Метод не того типа</title>
</head>
<body>
  <script src="main.js"></script>
</body>
</html>
main.js
JavaScript
const title = "чай";
try {
  title.map((char) => char.toUpperCase());
} catch (error) {
  console.log(error.name + ": " + error.message);
}

console.log([...title].map((char) => char.toUpperCase()));

Опциональный вызов не проверяет тип

Отсутствующий callback пропускается, но число нельзя вызвать даже через ?.(). Измените callback на функцию и сравните результат проверки типа.

index.html
HTML
<!doctype html>
<html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Опциональный вызов не проверяет тип</title></head><body><p>Результат — в консоли браузера.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const missing = undefined;
console.log(missing?.());
const callback = 0;
try {
  callback?.();
} catch (error) {
  console.log(error.name);
}
if (typeof callback === "function") {
  callback();
} else {
  console.log("Это не функция");
}

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

ECMAScript: Native Error Types.