Ошибка TypeScript: Type 'string | undefined' is not assignable to type 'string' — как исправить?

Понимание проблемы: почему возникает ошибка

Ошибка 'string | undefined' is not assignable to type 'string' возникает из-за того, что TypeScript строго следит за типами. Когда вы объявляете поле name?: string, это означает, что name может быть либо string, либо undefined. Даже если в вашем конкретном объекте user поле name определено, TypeScript не анализирует runtime-значения — он смотрит только на типы. Поэтому user.name имеет тип string | undefined, а функция greet ожидает строго string.

Вот несколько правильных способов решения этой проблемы, от самых безопасных до более рискованных:

1. Проверка с помощью if (рекомендуемый способ)

Самый надёжный способ — явно проверить, что значение существует, прежде чем его использовать:

if (user.name !== undefined) {
  greet(user.name); // Теперь TypeScript знает, что это точно string
}

// Или более короткая запись:
if (user.name) {
  greet(user.name); // truthy-проверка: отсекает undefined, null, пустую строку
}

После проверки TypeScript сужает тип string | undefined до string в блоке if.

2. Опциональная цепочка (optional chaining) с оператором ??

Если вам нужно передать значение по умолчанию при отсутствии поля:

const name = user.name ?? 'Гость'; // Если undefined, используем 'Гость'
greet(name); // name теперь точно string

Оператор ?? (nullish coalescing) заменяет undefined или null на значение по умолчанию.

3. Non-null assertion (осторожно!)

Если вы абсолютно уверены, что значение не может быть undefined, можно использовать оператор !:

greet(user.name!); // "Я гарантирую, что это не undefined"

Но это опасно: если вы ошибаетесь, в рантайме будет ошибка. Используйте только когда уверены на 100%.

4. Приведение типа (type assertion)

Альтернатива оператору !:

greet(user.name as string); // Принудительно говорим TypeScript, что это string

Тоже небезопасно — если значение undefined, ошибка будет в рантайме.

5. Изменение интерфейса (если поле всегда должно быть)

Если вы понимаете, что поле name на самом деле всегда обязательно, просто уберите вопросительный знак:

interface User {
  id: number;
  name: string; // теперь обязательно
}

Но это изменит требования к данным, поэтому подходит только если вы контролируете источник данных.

6. Функция с опциональным параметром

Можно изменить функцию greet, чтобы она принимала string | undefined:

function greet(name?: string) {
  console.log(`Привет, ${name ?? 'Гость'}!`);
}

greet(user.name); // Теперь работает, так как параметр опциональный

Рекомендация: Для вашего случая лучше всего подойдёт вариант с if или ??. Они делают код понятным и безопасным. Избегайте ! и as string без крайней необходимости.

function isString(value: unknown): value is string {
  return typeof value === 'string';
}

if (isString(user.name)) {
  greet(user.name); // TypeScript знает, что это string
}

function isNonEmptyString(value: unknown): value is string {
  return typeof value === 'string' && value.length > 0;
}

if (isNonEmptyString(user.name)) {
  greet(user.name);
} else {
  console.log('Имя не указано или пустое');
}

const users: (User | undefined)[] = [user, undefined, { id: 2, name: 'Борис' }];
const validUsers = users.filter(Boolean); // Отсеивает undefined
validUsers.forEach(u => greet(u.name ?? 'Гость')); // Безопасно