Монадическая обработка ошибок в TS: переходим с try/catch на Effect-TS

Если вы читаете это, вы, вероятно, уже потратили недели на отладку приложения, где ошибки возникают не там, где должны, а обработчики разрослись в лабиринт условий. Вы ловите ошибки, пробрасываете их, вкладываете блоки try/catch в другие try/catch. Результат — код, который сложно рассуждать, тестировать и поддерживать. Контроль потока ошибок ускользает, и это стоит денег на поддержке и нервах.
Существует иной путь, где ошибки становятся полноценными, типизированными гражданами вашего кода. Этот путь — использование монадических контейнеров через библиотеку Effect-TS. Он требует смены парадигмы, но окупается предсказуемостью, композируемостью и типовой безопасностью, которые невозможны с императивным try/catch. В этой статье мы разберем, как сделать этот переход, показав на конкретном сценарии, почему это работает и как начать применять это уже завтра.
Почему try/catch ломает нашу ментальную модель
Ключевая проблема классической обработки ошибок в TypeScript и JavaScript — ее неявность и побочные эффекты. Оператор throw прерывает нормальный поток выполнения, создавая второй, скрытый канал передачи данных. Сигнатура функции ничего не говорит о возможных сбоях.
Функция parseUserData(json: string): User может выбросить SyntaxError, TypeError, ValidationError или что-то еще. Типовая система TypeScript здесь бессильна. Вы не можете доверять типам, чтобы понять полный контракт функции. Это вынуждает либо игнорировать ошибки, либо писать избыточные, хрупкие обертки.
Рассмотрим реальный сценарий — цепочку асинхронных операций при регистрации пользователя:
- Проверить уникальность email в базе данных (может упасть сетевая ошибка).
- Захешировать пароль (может упасть ошибка алгоритма).
- Создать запись в БД (может упать ошибка ограничений).
- Отправить приветственное письмо (может упасть ошибка SMTP).
С try/catch каждая операция потребует вложенной обработки или проброса ошибок наверх. Управлять их типами и контекстом становится мучительно.
Распространенная и дорогая ошибка: проглатывание ошибок
Типичный антипаттерн выглядит так:
try {
const user = await createUser(req.body);
return user;
} catch (error) {
console.error('Что-то пошло не так:', error);
return null;
}
Код скрывает причину сбоя, возвращая null. Клиентский код теперь должен проверять на null, теряя контекст ошибки. В production это приводит к часам, потраченным на поиск источника «тихого» падения функционала. Ошибка не устраняется, она маскируется.
Effect-TS: ошибки как данные
Effect-TS — это библиотека для типобезопасного, функционального программирования в TypeScript. Ее ядро — абстракция Effect<R, E, A>. Это описание программы, которая для работы требует контекст R, может завершиться с ошибкой типа E или успешным значением типа A.
Ключевое отличие: Effect — это не промис и не значение. Это неизменяемое описание вычисления (blueprint). Оно ничего не делает, пока вы его не «запустите». Ошибка типа E явно указана в типе. Нет скрытых каналов. Если функция возвращает Effect<never, ValidationError, User>, вы точно знаете: она может провалиться только с ValidationError, не требует контекста и при успехе вернет User.
Базовые строительные блоки
Вместо throw вы используете конструкторы:
Effect.succeed(value)— создает успешный эффект.Effect.fail(error)— создает эффект, завершающийся с ошибкой.Effect.tryPromise(() => promise)— безопасно оборачивает промис в эффект, где ошибка становится частью типа E.
Эти примитивы композируются с помощью методов вроде map, flatMap (также gen), позволяя строить сложные программы из простых, предсказуемых частей.
Переписываем реальный сценарий с Effect
Вернемся к регистрации пользователя. Сначала определим типы ошибок как часть предметной области, а не как исключения.
class DatabaseError { readonly _tag = 'DatabaseError' }
class HashError { readonly _tag = 'HashError' }
class EmailServiceError { readonly _tag = 'EmailServiceError' }
// Каждая функция возвращает явно типизированный Effect
function checkEmailUniqueness(email: string): Effect<never, DatabaseError, boolean> { ... }
function hashPassword(password: string): Effect<never, HashError, string> { ... }
function createUserRecord(data: UserData): Effect<never, DatabaseError, User> { ... }
function sendWelcomeEmail(user: User): Effect<never, EmailServiceError, void> { ... }
Теперь сама программа регистрации, использующая синтаксис генератора (подобно async/await, но для эффектов):
import { Effect, pipe, Gen } from "effect"
const registerUser = (data: UserData): Effect<never, DatabaseError | HashError | EmailServiceError, User> =>
Effect.gen(function* (_) {
// yield* — это "разворачивание" эффекта, аналогично await
const isUnique = yield* _(checkEmailUniqueness(data.email));
if (!isUnique) {
return yield* _(Effect.fail(new DatabaseError()));
}
const hashedPassword = yield* _(hashPassword(data.password));
const user = yield* _(createUserRecord({ ...data, password: hashedPassword }));
// Можно игнорировать ошибку отправки почты или обработать ее отдельно, не прерывая регистрацию
yield* _(Effect.ignore(sendWelcomeEmail(user)));
return user;
});
Обратите внимание на тип возвращаемого значения: Effect<never, DatabaseError | HashError | EmailServiceError, User>. Это полный контракт. Компилятор TypeScript заставит вас обработать каждую возможную ошибку на верхнем уровне. Скрыть ошибку становится невозможно по дизайну системы типов.
Обработка и трансформация ошибок
Effect предоставляет мощный набор инструментов для работы с каналом ошибок E.
- Effect.catchAll: Позволяет «восстановиться» из любой ошибки, преобразовав ее в успех или другую ошибку.
- Effect.catchTag: Обработать ошибку конкретного типа.
- Effect.orElse: Предоставить альтернативный эффект на случай падения.
- Effect.merge: «Схлопнуть» каналы ошибки и успеха в один тип результата (подходит для обработки в API роутах).
Note: Важное преимущество Effect-TS — возможность аннотировать зависимости (контекст R). Ваши эффекты могут требовать подключения к БД, логгера или конфигурации. Это решает проблему скрытых зависимостей и упрощает тестирование через подмену контекста.
Вопрос и ответ
Вопрос: Разве такой подход не создает избыточного бойлерплейта для простых скриптов?
Для одноразовых скриптов или простых утилит он может быть излишним. Однако граница между «простым скриптом» и «ядром бизнес-логики» быстро стирается. Инвестиция в явное моделирование ошибок окупается на стадии масштабирования и рефакторинга. Для простых случаев вы можете использовать Effect.runPromise и обрабатывать ошибки на границе приложения один раз.
Стратегия внедрения в существующий проект
Резкий переход на Effect-TS для всего кодовой базы рискован. Эффективная стратегия — постепенное внедрение снизу вверх.
- Начните с нового модуля. Выберите относительно изолированную бизнес-логику (например, модуль отчетов или интеграции с внешним API). Реализуйте его полностью на Effect.
- Оберните старые промисы. Используйте
Effect.tryPromiseилиEffect.tryCatchдля интеграции с legacy-кодом. Это создает мост между мирами. - Обрабатывайте ошибки на границах. В точке входа (HTTP-контроллер, обработчик события) запускайте эффект с
Effect.runPromiseExit.Exitдает полную информацию: успех, ошибка или аварийное завершение. Преобразуйте это в ответ API. - Используйте внедрение зависимостей Effect. Постепенно выносите сервисы (БД, кэш, внешние API) в слой контекста R. Это сделает ваш код чище и полностью тестируемым.
К 2026 году подходы, основанные на явных эффектах и функциональной архитектуре, будут стандартом для сложных TypeScript-приложений, где надежность и способность к эволюции ценятся выше скорости первоначальной разработки. Раннее освоение этих паттернов даст вам и вашей команде значительное конкурентное преимущество.
Что делать дальше
Не откладывайте. Создайте новый branch в вашем проекте. Выберите одну функцию, которая страдает от неявных ошибок — например, загрузку данных с несколькими сетевыми запросами. Перепишите ее с использованием Effect-TS, явно определив типы всех возможных сбоев. Сравните получившийся тип функции с исходным. Запустите обе версии и проверьте, насколько проще стало писать тесты для новой. Этот практический эксперимент за час даст вам больше понимания, чем дни чтения документации. После этого оцените, какой модуль вашего приложения получит максимальную выгоду от подобной переработки, и составьте план для его поэтапного преобразования.
Подберите курс по теме статьи
Сравните программы, цены и длительность обучения в каталоге DigiUni.


