Типизация объектов в Typescript: гарантия единственного обязательного поля

Для API-запросов, требующих передачи одного из нескольких параметров (например, chatId, groupId или userId), необходимо строгое ограничение на выбор только одного обязательного поля. Стандартные опциональные типы type GetUnreadMessages = { groupId?: string; chatId?: string; userId?: string; } не обеспечивают такого контроля, допуская наличие нескольких или ни одного параметра.
Типизация объектов в Typescript: гарантия единственного обязательного поля
Изображение носит иллюстративный характер

Для решения этой задачи в Typescript можно использовать утилитарный тип Record, который позволяет создавать тип с определенными ключами и значениями. Объединяя его с Partial и исключениями undefined, можно получить тип, где только один из заданных ключей является обязательным, а остальные – undefined.

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

Данный подход позволяет автоматически трансформировать сгенерированные типы (например, из Swagger) для конкретных нужд, избегая ручного создания подобных структур. Это также позволяет уверенно использовать код, благодаря понятной структуре и тестам, гарантирующим корректность его работы.


Новое на сайте

19521Банковский троян VENON на Rust атакует Бразилию с помощью девяти техник обхода защиты 19520Бонобо агрессивны не меньше шимпанзе, но всё решают самки 19519Почему 600-килограммовый зонд NASA падает на землю из-за солнечной активности? 19518«Липовый календарь»: как расписание превращает работников в расходный материал 19517Вредоносные Rust-пакеты и ИИ-бот крадут секреты разработчиков через CI/CD-пайплайны 19516Как хакеры за 72 часа превратили npm-пакет в ключ от целого облака AWS 19515Как WebDAV-диск и поддельная капча помогают обойти антивирус? 19514Могут ли простые числа скрываться внутри чёрных дыр? 19513Метеорит пробил крышу дома в Германии — откуда взялся огненный шар над Европой? 19512Уязвимости LeakyLooker в Google Looker Studio открывали доступ к чужим базам данных 19511Почему тысячи серверов оказываются открытой дверью для хакеров, хотя могли бы ею не быть? 19510Как исследователи за четыре минуты заставили ИИ-браузер Perplexity Comet попасться на... 19509Может ли женщина без влагалища и шейки матки зачать ребёнка естественным путём? 19508Зачем учёные из Вены создали QR-код, который невозможно увидеть без электронного... 19507Девять уязвимостей CrackArmor позволяют получить root-доступ через модуль безопасности...
Ссылка