可 yield 的错误

可 yield 的错误（Yieldable Errors）是一类特殊的错误，可以直接在生成器函数中通过 Effect.gen yield 出来。 这类错误让你能够以直观的方式处理它们，而不必显式调用 Effect.fail。这简化了你在代码中管理自定义错误的方式。

Data.Error

Data.Error 构造函数提供了一种为可 yield 的错误定义基类的方式。

示例（创建并 yield 一个自定义错误）

import { Effect, Data } from "effect"

// Define a custom error class extending Data.Error
class MyError extends Data.Error<{ message: string }> {}

export const program = Effect.gen(function* () {
  // Yield a custom error (equivalent to failing with MyError)
  yield* new MyError({ message: "Oh no!" })
})

Effect.runPromiseExit(program).then(console.log)
/*
Output:
{
  _id: 'Exit',
  _tag: 'Failure',
  cause: { _id: 'Cause', _tag: 'Fail', failure: { message: 'Oh no!' } }
}
*/

Data.TaggedError

Data.TaggedError 构造函数让你可以定义带有唯一标签的自定义可 yield 错误。每个错误都有一个 _tag 属性，让你可以轻松区分不同的错误类型。因此，使用 Effect.catchTag 或 Effect.catchTags 这类函数来处理特定的 tagged error 会很方便。

示例（处理多个 tagged error）

import { Effect, Data, Random } from "effect"

// An error with _tag: "Foo"
class FooError extends Data.TaggedError("Foo")<{
  message: string
}> {}

// An error with _tag: "Bar"
class BarError extends Data.TaggedError("Bar")<{
  randomNumber: number
}> {}

const program = Effect.gen(function* () {
  const n = yield* Random.next
  return n > 0.5
    ? "yay!"
    : n < 0.2
      ? yield* new FooError({ message: "Oh no!" })
      : yield* new BarError({ randomNumber: n })
}).pipe(
  // Handle different tagged errors using catchTags
  Effect.catchTags({
    Foo: (error) => Effect.succeed(`Foo error: ${error.message}`),
    Bar: (error) => Effect.succeed(`Bar error: ${error.randomNumber}`),
  }),
)

Effect.runPromise(program).then(console.log, console.error)
/*
Example Output (n < 0.2):
Foo error: Oh no!
*/