(defect: unknown): Exit<never>Creates a failed Exit from a defect (unexpected error).
When to use
Use when you need unexpected, unrecoverable errors that should not appear in the typed error channel.
Details
The defect is wrapped in a Cause.Die internally.
Returns a Failure<never> with E = never, since defects do not appear in
the typed error channel.
Example (Creating a defect Exit)
import { Exit } from "effect"
const exit = Exit.die(new Error("Unexpected error"))
console.log(Exit.isFailure(exit)) // trueexport const const die: (
defect: unknown
) => Exit<never>
Creates a failed Exit from a defect (unexpected error).
When to use
Use when you need unexpected, unrecoverable errors that should not appear in
the typed error channel.
Details
The defect is wrapped in a Cause.Die internally.
Returns a Failure<never> with E = never, since defects do not appear in
the typed error channel.
Example (Creating a defect Exit)
import { Exit } from "effect"
const exit = Exit.die(new Error("Unexpected error"))
console.log(Exit.isFailure(exit)) // true
die: (defect: unknowndefect: unknown) => type Exit<A, E = never> = Success<A, E> | Failure<A, E>Represents the result of an Effect computation.
When to use
Use when you need to synchronously inspect whether an Effect computation
succeeded or failed.
Details
An Exit<A, E> is either Success<A, E> containing a value of type A, or
Failure<A, E> containing a Cause<E> describing why the computation
failed.
Since Exit is also an Effect, you can yield it inside Effect.gen.
Example (Pattern matching on an Exit)
import { Exit } from "effect"
const success: Exit.Exit<number> = Exit.succeed(42)
const failure: Exit.Exit<number, string> = Exit.fail("error")
const result = Exit.match(success, {
onSuccess: (value) => `Got value: ${value}`,
onFailure: (cause) => `Got error: ${cause}`
})
Namespace containing helper types shared by Exit values.
When to use
Use to reference helper types that describe the shared structure of Exit
values.
Exit<never> = import corecore.const exitDie: (
defect: unknown
) => Exit.Exit<never>