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

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

ざっくり言うと、Effect-TS は 成功・失敗・依存をすべて型で表現する Effect 型を中核に、TS で堅牢なバックエンドを書くためのエコシステム』</strong> です。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』</strong>。<a href="/articles/what-is-zod-typescript-validation">Zod</a> は単体で完結する手軽さ、Effect Schema はEffect 型と統合される強み』 がそれぞれの長所です。

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

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

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

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

Q. fp-ts との関係は？

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

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

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

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

A. 基本概念で 1〜2 週間、実プロジェクトで使いこなすまで 1〜2 ヶ月』</strong>が現実的な感触です。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