32 — Retry and deadlines

Effect.retry(schedule) repeats according to an explicit, bounded policy. Effect.timeout(duration) adds a typed TimeoutError and interrupts the underlying fiber when the deadline wins. Use Effect.timeoutOrElse when the domain needs a custom timeout failure.

Retry only transient operations, keep idempotency in view, and put deadlines around the complete operation rather than an arbitrary internal fragment.

The full test suite

The index.test.ts for this lesson, verbatim from steps/32-retry-and-timeout/.

1
import { describe, expect, it } from "vite-plus/test"
2
import { Effect, Exit, Schedule } from "effect"
3

4
describe("retry and timeout", () => {
5
  it("keeps retry and deadline policies visible", async () => {
6
    const exit = await Effect.runPromiseExit(
7
      Effect.fail("unavailable").pipe(Effect.retry(Schedule.recurs(2)), Effect.timeout("50 millis")),
8
    )
9
    expect(Exit.isFailure(exit)).toBe(true)
10
  })
11
})