Skip to content

Function: unwrapOr() ​

Call Signature ​

unwrapOr<R, ErrReturn>(onErr): (result) => ErrReturn | UnwrapOk<R>

Defined in: fp.ts:21

Takes the error handler and returns a function that accepts a Result. The returned function unwraps the Result, returning the data for Ok results and handling Err results using the provided error handler.

Type Parameters ​

R ​

R extends Result

The input Result type

ErrReturn ​

ErrReturn

The type returned for Err results

Parameters ​

onErr ​

(error) => NonPromise<ErrReturn>

The value or function that determines the value returned for Err results

Returns ​

A function that takes a Result and returns either the Ok data or the error value

(result): ErrReturn | UnwrapOk<R>

Parameters ​

result ​

NonPromise<R>

Returns ​

ErrReturn | UnwrapOk<R>

Example ​

typescript
const result1 = pipe(ok("hello"), unwrapOr("default")); // "hello"
const result2 = pipe(err("failed"), unwrapOr("default")); // "default"

Call Signature ​

unwrapOr<R, ErrReturn>(onErr): (result) => ErrReturn | UnwrapOk<R>

Defined in: fp.ts:24

Takes the error handler and returns a function that accepts a Result. The returned function unwraps the Result, returning the data for Ok results and handling Err results using the provided error handler.

Type Parameters ​

R ​

R extends Result

The input Result type

ErrReturn ​

ErrReturn

The type returned for Err results

Parameters ​

onErr ​

NonPromise<ErrReturn>

The value or function that determines the value returned for Err results

Returns ​

A function that takes a Result and returns either the Ok data or the error value

(result): ErrReturn | UnwrapOk<R>

Parameters ​

result ​

NonPromise<R>

Returns ​

ErrReturn | UnwrapOk<R>

Example ​

typescript
const result1 = pipe(ok("hello"), unwrapOr("default")); // "hello"
const result2 = pipe(err("failed"), unwrapOr("default")); // "default"

Call Signature ​

unwrapOr<R, ErrReturn>(onErr): (result) => Promise<ErrReturn | UnwrapOk<R>>

Defined in: fp.ts:27

Takes the error handler and returns a function that accepts a Result. The returned function unwraps the Result, returning the data for Ok results and handling Err results using the provided error handler.

Type Parameters ​

R ​

R extends OrPromise<Result>

The input Result type

ErrReturn ​

ErrReturn

The type returned for Err results

Parameters ​

onErr ​

OrFunction<OrPromise<ErrReturn>, [UnwrapErr<R>]>

The value or function that determines the value returned for Err results

Returns ​

A function that takes a Result and returns either the Ok data or the error value

(result): Promise<ErrReturn | UnwrapOk<R>>

Parameters ​

result ​

R

Returns ​

Promise<ErrReturn | UnwrapOk<R>>

Example ​

typescript
const result1 = pipe(ok("hello"), unwrapOr("default")); // "hello"
const result2 = pipe(err("failed"), unwrapOr("default")); // "default"