Как исправить ошибку TS2533: "Object is possibly 'null' or 'undefined'" в TypeScript

Понимание ошибки TS2533

Ошибка TS2533 возникает, когда TypeScript обнаруживает, что переменная может иметь значение null или undefined, но вы пытаетесь обратиться к её свойству или методу. Это одна из ключевых фич TypeScript, помогающая избежать ошибок времени выполнения. В вашем случае метод Array.find() возвращает User | undefined, поэтому компилятор справедливо предупреждает, что user может быть undefined.

Правильные способы решения

1. Проверка на null/undefined (рекомендуется)

Самый безопасный и понятный способ — явно проверить значение перед использованием:

const user = findUser(1);
if (user) {
  console.log(user.name);
} else {
  console.log('Пользователь не найден');
}

Этот подход гарантирует, что код не упадёт, если пользователь вдруг не найдётся. TypeScript поймёт, что внутри блока if (user) значение точно существует.

2. Оператор утверждения не-null (!)

Если вы абсолютно уверены, что значение не может быть null/undefined, используйте оператор ! (non-null assertion):

const user = findUser(1);
console.log(user!.name); // Внимание: подавляет проверку компилятора

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

3. Оператор опциональной цепочки (?.)

Если вам нужно безопасно обратиться к свойству, используйте ?.:

const user = findUser(1);
console.log(user?.name ?? 'Пользователь не найден');

Здесь user?.name вернёт undefined, если user равен null/undefined, а ?? (nullish coalescing) подставит значение по умолчанию.

4. Изменение сигнатуры функции

Лучшее решение — сделать тип возврата явным:

function findUser(id: number): User | undefined {
  return users.find(user => user.id === id);
}

// Теперь вызывающий код обязан обработать undefined
const user = findUser(1);
if (user) {
  console.log(user.name);
}

Или, если вы уверены, что пользователь всегда существует, используйте findUser с гарантией:

function findUserOrThrow(id: number): User {
  const user = users.find(user => user.id === id);
  if (!user) throw new Error(`Пользователь с id ${id} не найден`);
  return user;
}

Чего делать НЕ стоит

• Не отключайте проверки в tsconfig.json — установка strictNullChecks: false убирает эту и многие другие полезные проверки, делая код менее безопасным.
• Не используйте as для приведения типа — const user = findUser(1) as User тоже подавляет проверку, но может привести к ошибкам.

Итог

Лучшая практика — всегда явно обрабатывать случаи, когда значение может быть null или undefined. TypeScript помогает вам писать более надёжный код, а не мешает. Используйте проверки if, оператор ?. или меняйте возвращаемый тип функции — и ошибка TS2533 перестанет вас беспокоить.

function ensureDefined<T>(value: T | null | undefined, message?: string): NonNullable<T> {
  if (value === null || value === undefined) {
    throw new Error(message || 'Value is null or undefined');
  }
  return value;
}

// Использование:
const user = ensureDefined(findUser(1));
console.log(user.name); // Без ошибки TS2533

function isUser(value: User | undefined): value is User {
  return value !== undefined;
}

const user = findUser(1);
if (isUser(user)) {
  console.log(user.name); // TypeScript знает, что user — точно User
}