Если сервер вернул данные не того типа, например строку вместо числа, как это можно обнаружить и обработать?

TypeScript проверяет типы только на этапе компиляции. Когда данные приходят с сервера, они попадают в приложение как обычные значения JavaScript, и компилятор уже не может гарантировать, что там действительно число, а не строка. Поэтому проверку нужно делать вручную во время выполнения.

Ручная проверка через typeof

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

function parseUser(data) {
  if (typeof data.age !== 'number') {
    throw new Error('age must be a number');
  }
  return { name: data.name, age: data.age };
}

try {
  const user = parseUser(await res.json());
  console.log(user.age + 1);
} catch (e) {
  console.error('Bad response:', e.message);
}

Валидация схемы через Zod

Когда полей много, ручные проверки становятся громоздкими. Библиотеки вроде Zod описывают схему и сами проверяют все поля, возвращая типизированный результат:

import { z } from 'zod';

const UserSchema = z.object({
  name: z.string(),
  age: z.number(),
});

const result = UserSchema.safeParse(await res.json());
if (!result.success) {
  console.error(result.error.issues);
} else {
  console.log(result.data.age); // number
}

Что делать при несоответствии

• Выбросить ошибку и показать пользователю понятное сообщение.
• Подставить значение по умолчанию, если поле не критично.
• Залогировать проблему и отправить событие в мониторинг.

Итог: валидация ответов сервера защищает приложение от неожиданных данных и делает ошибки предсказуемыми. Применяйте её на границе с внешним API, особенно если контракт может меняться.