Effect-TS とは何か？TypeScript の関数型エコシステムとエラー・依存・並行を型で扱う設計

Effect-TS ってよく聞くけど、結局何をするライブラリ？ Promise / async-await でいいんじゃないの？ 「関数型ってまた難しい話？」 ── 2023 年あたりから TypeScript の関数型コミュニティで急速に存在感を増した Effect-TS は、「TS バックエンドの新しい標準」 を目指す野心的なプロジェクトです。

ざっくり言うと、Effect-TS は 成功・失敗・依存をすべて型で表現する Effect 型を中核に、TS で堅牢なバックエンドを書くためのエコシステム です。 「Promise だと失敗の型が伝わらない」 「関数の依存を引数で渡し続けるのが辛い」 「リトライ / タイムアウト / 並行性を毎回手で書きたくない」 ── こうした TS バックエンド開発の悩みを、体系的に解決する ことを目指しています。

この記事では、2026 年 5 月時点の Effect-TS v3 系をベースに、仕組み・なぜ生まれたか・基本コード・採用判断軸 を整理します。 仕様は活発に変化しているので、最終確認は 公式 を見るのが安全です。

なぜ Effect-TS が生まれたか

「普通の Promise / async-await で何が困るのか」 が分かると、Effect の動機が見えます。

Effect は これらすべてを 「Effect 型」 のエコシステムで体系的に扱う ことを目指したライブラリです。

Effect 型の中核

Effect の世界で最も大事な型が Effect<Success, Error, Requirements> です。

import { Effect } from 'effect';

// User を取ってくる Effect(成功時 User、失敗時 UserNotFound、依存 Database)
const getUser = (id: string): Effect.Effect<User, UserNotFound, Database> =>
  Effect.gen(function* () {
    const db = yield* Database;
    const user = yield* db.find(id);
    return user;
  });

「実行を遅延し、型で失敗と依存を表現する」 のが、Effect の体験を一言で表す部分です。

何が嬉しいか — 具体例

「Promise」 と 「Effect」 で同じ処理を書き比べると、違いが見えます。

Promise 版

async function getUser(id: string): Promise<User> {
  const db = getDatabase(); // 依存はグローバル / 引数のどれかでうやむや
  try {
    return await db.find(id);
  } catch (err) {
    // どんなエラーが投げられるかは型に出ない
    throw new UserNotFound(id);
  }
}

// リトライしたい場合は手書き
async function getUserWithRetry(id: string): Promise<User> {
  for (let i = 0; i < 3; i++) {
    try { return await getUser(id); }
    catch (e) { if (i === 2) throw e; }
  }
  throw new Error('unreachable');
}

Effect 版

const getUser = (id: string) =>
  Effect.gen(function* () {
    const db = yield* Database; // 依存は型レベルで明示
    return yield* db.find(id);  // 失敗時の型も追える
  });

// リトライは標準機能
const getUserWithRetry = (id: string) =>
  getUser(id).pipe(Effect.retry({ times: 3 }));

「型と合成可能性で堅牢な TS バックエンドを書く」 のが Effect の中心的な価値です。

エコシステムの広がり

Effect-TS は Effect 型 + 周辺ライブラリ群 でひとつのエコシステムを形成しています。

「1つのライブラリで TS バックエンドの基本ピースを全部カバーする」 のが Effect のスケールです。

いつ Effect-TS を選ぶか

「Effect を入れる価値が出る案件」 を整理します。

「堅牢な TS バックエンドにコミットできるチーム」 で大きく光るタイプの道具です。

ハマりやすいポイント

便利な反面、現場で踏みやすい注意点も整理します。

「良いプログラムを書ける可能性を上げる代わりに、書く側の学習コストを払う」 のが Effect の特徴です。

AI 時代の Effect-TS

AI 連携の文脈で Effect-TS の役割を整理します。

「AI 時代の信頼性の高い TS バックエンド」 を作りたいときに、Effect-TS の価値は高まっています。

Effect-TS に関するよくある質問

Q. Effect-TS と Zod、どちらを選ぶべきですか？

A. 検証だけなら Zod、エコシステム全体を Effect で統一するなら Effect Schema。Zod は単体で完結する手軽さ、Effect Schema は 「Effect 型と統合される強み」 がそれぞれの長所です。

Q. Effect-TS は本番運用に耐えますか？

A. 耐えます。Effect は Scala の ZIO の TS 版という長年の設計を継承しており、Vercel・Shopify・Microsoft などの一部チームでも採用事例があります。「採用人口は React ほどではない」 ので、コミュニティが大きい React 系ライブラリほどの情報量は期待できない、と認識しておくのが安全です。

Q. Promise から Effect への移行は大変ですか？

A. 概念の学習が中心です。書き換え自体はそこまで大変ではないですが、「Effect の世界観」 を理解しないと正しく書けません。「小さなコードから順に書き換える」 段階移行が現実的です。

Q. fp-ts との関係は？

A. Effect-TS は fp-ts の後継的な存在として位置づけられています。同じ作者陣の一部が関わっていて、「fp-ts より統合的でモダンな API」 を提供しています。「新規プロジェクトは Effect」 が2026 年現在の標準的な選び方です。

Q. Node.js / Bun / Deno で動きますか？

A. はい、すべてのランタイムで動きます。Web 標準 API ベースのコードが多く、Bun や Deno、Cloudflare Workers などのエッジランタイムでも問題なく使えます。

Q. 学習にどのくらいかかりますか？

A. 基本概念で 1〜2 週間、実プロジェクトで使いこなすまで 1〜2 ヶ月が現実的な感触です。「Promise / async-await に慣れている人ほど、最初の戸惑い」 が大きい傾向。「公式チュートリアル + Effect.gen」 から始めて、徐々に Layer / Schema / Stream に広げると進めやすいです。

Q. Effect-TS を学ぶ最短ルートは？

A. ① 公式の 「Getting Started」 を1セット、② 「Effect.gen + yield*」 で簡単な処理、③ 「Effect.retry / Effect.timeout」 で典型処理、④ 「Context / Layer」 で DI、⑤ 「Schema」 で検証、の5ステップが王道です。「まず Effect.gen を書いて、yield* に慣れる」 のが最初のハードルです。

参考リンク

• Effect-TS: 公式
• Effect-TS Docs: Documentation
• Effect-TS: GitHub
• ZIO(Scala): 公式
• Effect Schema: Docs
• Effect blog: Resources