Гайды

Почему this равен undefined в JavaScript — 3 причины и как починить

Иллюстрация: пульт унесли в другую комнату — жмёшь кнопку, а телевизора нет

Метод отлично работал, пока ты вызывал его руками: counter.increment(). Потом ты повесил его на кнопку — и всё сломалось. В консоли Cannot read properties of undefined. Или ещё коварнее: ошибки нет, а на экране вместо числа NaN.

Код метода ты не трогал. Изменилось только одно — кто его вызвал. И вот тут главная странность JavaScript: this внутри функции определяется не там, где она написана, а там, где её вызвали.

Что вообще такое this

this — это слово «я» для метода. Когда ты пишешь counter.increment(), объект слева от точки становится this. Метод говорит «мой счётчик» — и это счётчик counter.

А теперь самое важное. Если точки слева нет, «я» теряется. Метод всё тот же, но хозяина у него больше нет.

Представь пульт от телевизора. В комнате с телевизором он работает. Унёс его в другую комнату — кнопки те же, а переключать нечего. Пульт не сломан. Он просто не знает, к какому телевизору относится.

Теперь три случая, когда точка незаметно пропадает. Идём от самого частого.

Причина 1. Метод передали как колбэк (самая частая)

Ты отдаёшь метод кому-то, кто вызовет его позже: кнопке, таймеру, другой функции. Это называется колбэк.

const counter = {
  count: 0,
  increment() {
    this.count += 1
  }
}

button.addEventListener("click", counter.increment)

Смотри внимательно: counter.increment — без скобок. Ты передал саму функцию, а не вызов. Кнопка потом вызовет её сама — и this станет кнопкой, а не счётчиком. У кнопки нет count, получается undefined + 1, то есть NaN. С setTimeout то же самое, только this станет глобальным окном.

Как проверить. Первой строкой метода поставь console.log(this). Увидишь кнопку, window или undefined вместо своего объекта — это оно.

Как починить. Оберни вызов в стрелочную функцию, чтобы точка вернулась на место:

button.addEventListener("click", () => counter.increment())

Второй способ — привязать хозяина навсегда: counter.increment.bind(counter). Работает так же, просто читается хуже.

В старых React-компонентах на классах это та же история: onClick={this.handleClick} передаёт метод без хозяина. Поэтому в таком коде ты часто увидишь в конструкторе строку this.handleClick = this.handleClick.bind(this). Выглядит как заклинание, но смысл простой: «запомни, чей ты».

Причина 2. Обычная function внутри метода

Внутри метода всё хорошо, но ты пишешь ещё одну функцию — например, для forEach:

class Cart {
  constructor() {
    this.items = [990, 450]
    this.total = 0
  }

  sum() {
    this.items.forEach(function (price) {
      this.total += price
    })
  }
}

Здесь падает Cannot read properties of undefined (reading 'total'). У внутренней function свой собственный this. И forEach вызывает её без всякой точки. Внутри класса это значит undefined.

Как проверить. Ошибка указывает на строку внутри вложенной функции, а не в самом методе.

Как починить. Замени function на стрелку. У стрелочной функции своего this нет — она берёт его снаружи, из метода:

this.items.forEach((price) => {
  this.total += price
})

Это тот же механизм, что и с переменными: стрелка «видит» окружение, где её написали. Подробнее про такую видимость — в статье что такое область видимости.

Причина 3. Стрелка там, где нужен метод

Обратная ситуация. Раз стрелки такие удобные, их пишут вообще везде:

const cart = {
  items: [990, 450],
  count: () => this.items.length
}

И снова ошибка. Стрелка не берёт this у объекта — она берёт его снаружи. А снаружи объекта никакого cart нет.

Как проверить. Метод объявлен через => прямо внутри объекта.

Как починить. Сам метод объекта пиши обычным способом: count() { return this.items.length }. Стрелки оставь для функций внутри методов — как в причине 2.

Как быстро разобраться в следующий раз

Правило из двух строк:

  • Метод объекта — обычная запись name() {}.
  • Функция внутри метода или колбэк — стрелка () => {}.

Если ошибка всё равно ставит в тупик, разбери её по частям — как в статье как читать сообщение об ошибке. Строка и имя свойства в скобках почти всегда показывают, где потерялся хозяин.

Почему в React-компонентах эта ошибка встречается редко?

Современные компоненты — это функции, а не классы, и this в них не используется вовсе. Ошибка с this в React — примета старого кода на классах.

Что такое this в Python?

Там его роль играет self, и Python передаёт его явно, первым аргументом метода. Поэтому потеряться ему гораздо сложнее.

Может ли this быть undefined без ошибки?

Да. Если ты только читаешь свойство, получишь тихий undefined или NaN. Ошибка появится, лишь когда попробуешь пойти глубже: this.user.name.

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

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

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

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

Все статьи →