unnullish
unnullish returns undefined if value is nullish, otherwise it executes callback and returns the result. It is an opposite function of the nullish coalescing operator (??).
Usage
unnullish
unnullish<T, R>(value: T | null | undefined, callback(v: T) => R): R | undefined
The function is useful when you want to apply some transformation functions to optional values. For example,
import { unnullish } from "./mod.ts";
type Options = {
foo?: string;
bar?: number;
};
function sayHello(v: string): string {
return `Hello ${v}`;
}
const options: Options = {
foo: unnullish(Deno.env.get("foo"), (v) => sayHello(v)),
// instead of
//foo: Deno.env.get("foo") != null
// ? sayHello(Deno.env.get("foo"))
// : undefined,
bar: unnullish(Deno.env.get("bar"), (v) => parseInt(v, 10)),
// instead of
//bar: Deno.env.get("bar") != null
// ? parseInt(Deno.env.get("bar"), 10)
// : undefined,
};
Note that the function returns undefined even the input is null, mean that you may need to use nullish coalescing operator to normalize the result. For example,
import { unnullish } from "./mod.ts";
console.log(unnullish(null, () => 0));
// -> undefined
console.log(unnullish(undefined, () => 0));
// -> undefined
console.log(unnullish(null, () => 0) ?? null);
// -> null
console.log(unnullish(undefined, () => 0) ?? null);
// -> null
Deno
Use import { unnullish } from "https://deno.land/x/unnullish/mod.ts";
Node
Use import { unnullish } from "unnullish";
License
The code follows MIT license written in LICENSE. Contributors need to agree that any modifications sent in this repository follow the license.
59 Dec 23, 2022
307 Dec 27, 2022
42 Dec 8, 2022
18 Dec 5, 2022
15 Sep 24, 2022
21 Jun 20, 2022
14 Dec 8, 2022
19 Dec 19, 2022
19 Apr 8, 2022
2 Jun 17, 2022