decodeUnknownExit | Effect Schema

decodeUnknownExit is a synchronous decoder that returns an Exit value instead of throwing.

Exit is an Effect data structure for representing outcomes explicitly: either Success (with a value) or Failure (with a cause).

Exit.Success contains the decoded value.
Exit.Failure contains the decode error (a SchemaError) in the cause.

1
import { Cause, Exit, Schema } from "effect";
2

3
const schema = Schema.Struct({
4
  name: Schema.String,
5
  age: Schema.Number,
6
});
7

8
const decode = Schema.decodeUnknownExit(schema);
9

10
// Happy path
11
const ok = decode({ name: "Alice", age: 30 });
12

13
if (Exit.isSuccess(ok)) {
14
  console.log("Decoded Value:", ok.value);
15
}
16

17
// Error path
18
const bad = decode({ name: 42, age: "30" });
19

20
if (Exit.isFailure(bad)) {
21
  console.log("Error Message:", Cause.pretty(bad.cause));
22
}

In the example above, I use Cause.pretty(bad.cause) to turn the Effect Cause (a structured error tree) into a human-readable string for logs.

Stay in the loop