Напишите на TypeScript type guard, который проверит, что ответ API действительно содержит пользователя, прежде чем с ним работать

ЗадачаMiddleИногда

Проверила команда СопроводОбновлено

Короткий ответ

Примите значение как 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 и с ее помощью оставьте в списке только корректных пользователей, прежде чем показывать их врачу.

Элемент ответаПройдет проверку
{"id":1,"name":"Ольга Петрова","phone":"+7 900 111-22-33"}да
{"id":2,"name":"Игорь Лебедев","phone":null}да
{"id":"3","name":"Анна"}нет
nullнет

Как подойти к решению

  1. Объявите параметр типа unknown, чтобы TypeScript не дал читать поля до проверки
  2. Проверьте, что значение — объект и не null
  3. Проверьте каждое поле через in и typeof и повторите тип поля целиком
  4. Укажите тип результата value is User, чтобы ответ true сужал тип
  5. Отфильтруйте список через 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) на список, каждое поле проверяется один раз.

TypeScript
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

Похожие вопросы

ЗнаниеJuniorЧасто

Чем type отличается от interface в TypeScript и когда что выбрать?

Оба описывают форму объекта, и для обычного объекта разница почти незаметна. interface можно объявить повторно, объявления сольются, а расширяют его через extends. type дает имя любому типу: объединению, кортежу, примитиву, функции, расширяют его пересечением &. Частая договоренность в командах: interface для объектов и публичных API, type для объединений и вычисляемых типов.

  • TypeScript
  • типы
278
ЗнаниеMiddleЧасто

Что такое дженерики в TypeScript и зачем ограничивать их через extends?

Дженерик — параметр типа, который подставляется при вызове функции или создании класса. Он сохраняет связь между входом и выходом: положили в кэш Club, получили Club, без any и приведений. Ограничение extends говорит, что тип должен уметь: T extends { id: number } пускает только объекты с числовым id, и внутри кода можно спокойно читать item.id.

  • TypeScript
  • типы
254
ЗнаниеSeniorЧасто

Как работают условные типы и infer в TypeScript?

Условный тип выбирает один из двух типов по проверке T extends U ? X : Y, как тернарный оператор, только над типами. infer объявляет переменную типа внутри условия и достает часть проверяемого типа: результат функции, элемент массива, значение промиса. Если T — голый параметр, а на вход пришло объединение, условие применяется к каждому члену отдельно.

  • TypeScript
  • типы
214
ЗадачаSeniorИногда

Напишите свою версию Promise.all: результаты в исходном порядке, отказ при первой ошибке

Создайте новый промис и подпишитесь на каждый элемент через Promise.resolve(item).then. Результат кладите по индексу элемента, а не в конец массива, и уменьшайте счетчик невыполненных промисов. Когда счетчик дойдет до нуля, вызовите resolve с массивом. Первую ошибку передайте в reject: после этого промис завершен, следующие ошибки он проигнорирует.

  • JavaScript
  • асинхронность
  • промисы
174

Частые вопросы по теме

Короткие ответы на частые вопросы по этой теме.

Объявлением типа результата. После обычной функции с boolean TypeScript ничего не знает о значении внутри if. Тип value is User сообщает компилятору: если вернулось true, значение — пользователь. Код внутри функции может быть одинаковым.

Решите вместе с командой. Для списка пользователей разумно отбросить запись и отправить ошибку в мониторинг с id и названием поля, чтобы бэкенд починил данные. Если без ответа экран не работает, покажите сообщение об ошибке и кнопку «Повторить».

Сужение типов через typeof, in, instanceof и Array.isArray, разницу unknown и any, объединения с null. Откройте раздел Narrowing в документации TypeScript и прорешайте его примеры: задачи middle-уровня строятся на тех же приемах.

Общие вопросы на интервью

Общий вопросС опытомЧасто

Почему вы хотите работать у нас?

Назовите две-три причины, которые связывают вас именно с этой компанией: продукт, задачи, масштаб, команда. Каждую подкрепите фактом, который нашли сами: новость, проект, текст вакансии, свой опыт клиента. Потом покажите, что принесете со своей стороны. Слова о стабильности и известном бренде подходят любой компании, поэтому на них ответ не держится.

  • мотивация
  • о компании
290
Общий вопросБез опытаЧасто

Какие у вас сильные стороны?

Хватит двух-трех сильных сторон, которые нужны на этой работе, если к каждой есть пример: что сделали и какой был результат. Берите качества из текста вакансии, а не из списка «ответственный, коммуникабельный». Без опыта примеры ищите в учебе, практике и подработке. Говорите спокойно, без лишней скромности и без хвастовства.

  • сильные стороны
  • без опыта
276
Общий вопросБез опытаЧасто

Кем вы видите себя через 5 лет?

Расскажите, какие задачи хотите решать через несколько лет и чему для этого научитесь. Свяжите план с тем, что дает эта компания, и покажите первый шаг, который уже сделали. Точную должность называть не обязательно. Важнее, чтобы план был реальным и вел через эту работу, а не мимо нее.

  • мотивация
  • карьерные планы
289
ИсторияС опытомЧасто

Расскажите о конфликте с коллегой: из-за чего он возник и как вы его решили?

Расскажите один реальный конфликт по рабочему вопросу: из-за чего разошлись, чего хотела каждая сторона и как вы договорились. Говорите спокойно, без оценок коллеги. Покажите, что вы искали решение, где-то уступили и сохранили рабочие отношения. Закончите результатом и тем, что теперь делаете, чтобы похожий спор не повторился.

  • конфликты
  • работа в команде
252
ИсторияС опытомЧасто

Каким профессиональным достижением вы гордитесь больше всего?

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

  • достижения
  • результат в цифрах
276
Общий вопросБез опытаЧасто

Опыта работы еще нет, а интервьюер просит рассказать о себе: что вы скажете?

Начните с того, кто вы сейчас и на какую работу пришли. Вместо стажа расскажите об учебе, практике и подработке, которые похожи на задачи вакансии, и назовите один результат с цифрой. Закончите тем, почему хотите начать карьеру именно здесь. Уложитесь в одну-две минуты и не пересказывайте резюме по порядку.

  • о себе
  • без опыта
244

Вопросы руководителю на интервью

ИсторияРуководительЧасто

Как вы делегируете задачи: что отдаете команде, а что оставляете себе?

Назовите свое правило: что вы отдаете команде и что оставляете себе, и покажите его на одной задаче. Расскажите, кому и почему передали, какие полномочия и рамки дали, как проверяли без мелкого контроля. Закончите честным итогом: что получилось хуже или медленнее, чем у вас, и что вы выиграли.

  • делегирование
  • команда
255
КейсРуководительЧасто

Два сотрудника вашей команды месяц не разговаривают друг с другом, и общий отчет уже сорвал срок — что сделаете?

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

  • конфликт
  • ответственность
242
ИсторияРуководительЧасто

Расскажите о сотруднике, которого вы вырастили: каким он пришел и чего добился?

Возьмите одного человека и покажите путь: каким он пришел, какие задачи вы ему давали по нарастающей и чем помогали, кем он стал и за какой срок. Назовите цифру роста: новая должность, своя зона, люди в подчинении. Скажите честно, где он вырос сам, а где сработали ваши решения.

  • развитие сотрудников
  • наставничество
303
ИсторияРуководительЧасто

Расскажите о цели, которую ваша команда не выполнила: когда вы это поняли и что сделали?

Назовите цель с цифрой и честный итог. Главное в ответе — момент, когда вы поняли, что цель срывается, и по какой цифре это увидели. Дальше расскажите, кому и когда сказали, что пересобрали, чтобы спасти главное, и какой один вывод сделали для следующего плана.

  • цели
  • провал
241
Общий вопросРуководительЧасто

Как вы измеряете результат своей команды?

Назовите два-три показателя, которые отражают то, ради чего существует ваша команда, и их текущие цифры. Добавьте показатель качества, который не дает гнаться за одним числом. Скажите, как часто смотрите на цифры, кто их видит и какое решение вы приняли по ним в последний раз.

  • показатели
  • цели
216
ИсторияРуководительЧасто

Расскажите, как вы разложили цель компании на задачи для своей команды

Возьмите одну цель компании с цифрой и сроком и покажите, как вы ее разбили: на какие части, по какому признаку, какие личные цели получил каждый сотрудник. Расскажите, как следили за ходом и что меняли по дороге. Закончите итогом план-факт честно, даже если цель выполнена не целиком.

  • цели
  • планирование
227