Напишите на TypeScript type guard, который проверит, что ответ API действительно содержит пользователя, прежде чем с ним работать
Проверила команда Сопровод · Обновлено
Короткий ответ
Примите значение как unknown и объявите тип результата value is User. Внутри проверьте, что это объект и не null, затем каждое поле через in и typeof: id — число, name — строка, phone — строка или null. Если функция вернула true, TypeScript считает значение пользователем. Список отфильтруйте через filter(isUser) и получите User[].
Почему этот вопрос задают
Данные с сервера — то место, где типы TypeScript чаще всего расходятся с реальностью. Здесь видно, умеете ли вы проверять данные во время выполнения и сужать тип так, чтобы компилятор помогал дальше.
Условие задачи
Сервис записи в стоматологическую клинику получает от API список пользователей, записанных на прием. У каждого должны быть поля id (число), name (строка) и phone (строка или null). Иногда сервер присылает поврежденные записи: id строкой, запись без телефона, null вместо объекта. Напишите на TypeScript функцию isUser(value: unknown): value is User и с ее помощью оставьте в списке только корректных пользователей, прежде чем показывать их врачу.
Как подойти к решению
- Объявите параметр типа
unknown, чтобы TypeScript не дал читать поля до проверки - Проверьте, что значение — объект и не
null - Проверьте каждое поле через
inиtypeofи повторите тип поля целиком - Укажите тип результата
value is User, чтобы ответtrueсужал тип - Отфильтруйте список через
filter(isUser)и проверьте записи с ошибками
Решение
После 'id' in value TypeScript, начиная с версии 4.9, добавляет к типу объекта поле id типа unknown и разрешает читать его без as. Предикат value is User выносит результат проверки наружу: в filter он превращает unknown[] в User[]. Тип unknown[] у list указан явно: Array.isArray сузил бы body до any[]. Время O(n) на список, каждое поле проверяется один раз.
type User = { id: number; name: string; phone: string | null };
function isUser(value: unknown): value is User {
return (
typeof value === 'object' && value !== null &&
'id' in value && typeof value.id === 'number' &&
'name' in value && typeof value.name === 'string' &&
'phone' in value && (typeof value.phone === 'string' || value.phone === null)
);
}
const raw = '[{"id":1,"name":"Ольга Петрова","phone":"+7 900 111-22-33"},' +
'{"id":2,"name":"Игорь Лебедев","phone":null},{"id":"3","name":"Анна"},null]';
const body: unknown = JSON.parse(raw);
const list: unknown[] = Array.isArray(body) ? body : [];
const users = list.filter(isUser);
console.log(`Пользователей: ${users.length} из ${list.length}`);
console.log(users.map((u) => u.name).join(', '));Пользователей: 2 из 4 Ольга Петрова, Игорь Лебедев
Что спросят следом
Что будет, если type guard проверяет не все поля?
Как написать проверку, которая бросает ошибку вместо
false?Когда ручной type guard стоит заменить схемой вроде zod?
Доступно по подписке
Ответы на эти вопросы
Частые ошибки
«Напишу
const users = body as User[]»Приведение через
asтолько выключает проверку компилятора, данные при этом не меняются. Строка"3"вместо числа дойдет до таблицы записи. Проверяйте данные функцией, которая смотрит на каждое поле«Проверю
typeof value === 'object', этого хватит»typeof nullтоже дает'object', и массив проходит эту проверку. Добавьтеvalue !== nullи проверьте поля черезinиtypeof«Обойдусь
any: данные же с нашего сервера»С
anyкомпилятор пропустит любое обращение к полям, и опечаткаuser.nmaeдойдет до экрана врача. Для неизвестных данных беритеunknown: с ним TypeScript не даст читать поля без проверки«Проверю
phoneчерезtypeof value.phone === 'string'»По типу телефон бывает
null, и такой пользователь не пройдет проверку и пропадет из списка. Повторите в проверке весь тип поля: строка илиnull
Сигналы для интервьюера
Сильный ответ
Проверяет решение на записи с ошибкой в каждом поле и объясняет, что увидит врач, если проверку пропустить
Тревожный сигнал
Проверка написана верно, но кандидат не знает, почему после 'id' in value TypeScript разрешает читать value.id
Красный флаг
Предлагает сравнить ответ с образцом через JSON.stringify или посчитать ключи через Object.keys, не глядя на типы полей
Как еще могут спросить
- Что такое пользовательский type guard и как его написать?
- Как проверить на TypeScript, что JSON с сервера соответствует типу?
- Как сузить тип
unknownдо конкретного интерфейса? - Напишите функцию с предикатом
value is Userдля данных из API











