(defect: unknown): Cause<never>Creates a Cause containing a single Die reason with the
given defect.
When to use
Use to construct a cause from an untyped defect or unexpected thrown value.
Example (Creating a die cause)
import { Cause } from "effect"
const cause = Cause.die("Unexpected")
console.log(cause.reasons.length) // 1
console.log(Cause.isDieReason(cause.reasons[0])) // trueexport const const die: (
defect: unknown
) => Cause<never>
Creates a Cause containing a single Die reason with the
given defect.
When to use
Use to construct a cause from an untyped defect or unexpected thrown value.
Example (Creating a die cause)
import { Cause } from "effect"
const cause = Cause.die("Unexpected")
console.log(cause.reasons.length) // 1
console.log(Cause.isDieReason(cause.reasons[0])) // true
die: (defect: unknowndefect: unknown) => interface Cause<out E>A structured representation of how an Effect failed.
When to use
Use to preserve the full structured failure information for an effect instead
of collapsing it to a single error value.
Details
Access the individual failure entries through the reasons array, then
narrow each entry with
isFailReason
,
isDieReason
, or
- Use
hasFails
/
hasDies
/
hasInterrupts
to test
for the presence of specific reason kinds without iterating.
- Use
findError
/
findDefect
to extract the first value
of a given kind.
- Use
combine
to merge two causes.
Cause implements Equal — two causes with the same reasons (by value)
compare as equal.
Example (Creating and inspecting a cause)
import { Cause } from "effect"
const cause = Cause.fail("Something went wrong")
console.log(cause.reasons.length) // 1
console.log(Cause.isFailReason(cause.reasons[0])) // true
Companion namespace for the Cause interface.
Cause<never> = import corecore.const causeDie: (
defect: unknown
) => Cause.Cause<never>