		{
		"name": "@softwareventures/nullable",
		"version": "1.2.1",
		"version": "1.2.2",
		"description": "Pure functional utilities for nullable types",
		@@ -26,3 +26,3 @@ "keywords": [
		"dependencies": {
		"tslib": "2.1.0"
		"tslib": "2.2.0"
		},
		@@ -36,7 +36,7 @@ "devDependencies": {
		"cz-conventional-changelog": "3.3.0",
		"eslint": "7.23.0",
		"eslint": "7.24.0",
		"prettier": "2.2.1",
		"semantic-release": "17.4.2",
		"ts-node": "9.1.1",
		"typescript": "4.2.3"
		"typescript": "4.2.4"
		},
		@@ -43,0 +43,0 @@ "eslintConfig": {

-25

index.test.ts

		import test from "ava";
		import {map} from "./index";

		test("map", t => {
		t.is(
		map(null, (e: number) => e + 1),
		null
		);
		t.is(
		map(undefined, (e: number) => e + 1),
		null
		);
		t.is(
		map(2, e => e + 1),
		3
		);
		t.is(
		map(2, () => null),
		null
		);
		t.is(
		map(2, () => {}),
		null
		);
		});

-70

index.ts

		/** Tests if the specified value is null or undefined.
		*
		* Useful as the predicate of filter functions and similar. */
		export function isNull<T>(value: unknown): value is null \| undefined {
		return value == null;
		}

		/** Tests if the specified value is null or undefined.
		*
		* Useful as the predicate of filter functions and similar. */
		export function isNotNull<T>(value: T \| null \| undefined): value is T {
		return value != null;
		}

		/** Returns the specified value, or the default value if the specified value
		* is null or undefined.
		*
		* If the default value is expensive to compute, consider using
		* {@link mapNull} instead. */
		export function defaultValue<T>(nullable: T \| undefined \| null, defaultValue: T): T {
		return nullable ?? defaultValue;
		}

		/** Returns a function that returns the specified value, or the default value
		* if the specified value is null or undefined.
		*
		* If the default value is expensive to compute, consider using
		* {@link mapNullFn} instead. */
		export function defaultValueFn<T>(defaultValue: T): (nullable: T \| undefined \| null) => T {
		return nullable => nullable ?? defaultValue;
		}

		/** If the specified value is null or undefined, returns null.
		*
		* Otherwise, passes the specified value to the provided function and returns
		* the return value of that function. */
		export function map<T, U>(nullable: T \| undefined \| null, f: (element: T) => U): U \| null {
		return nullable == null ? null : f(nullable) ?? null;
		}

		/** Returns a function that takes a nullable value as its argument.
		*
		* If the function is called with null or undefined, it returns null.
		*
		* Otherwise, the argument is passed to the callback `f` and the
		* return value of `f` is returned.
		*
		* Curried variant of {@link map}. */
		export function mapFn<T, U>(f: (element: T) => U): (nullable: T \| undefined \| null) => U \| null {
		return nullable => map(nullable, f);
		}

		/** Returns the specified value or, if the value is null or undefined, calls
		* the provided callback and returns the result of that function call.
		*
		* Useful as an alternative to {@link defaultValue} if the default value is
		* expensive to compute. */
		export function mapNull<T, U = T>(nullable: T \| undefined \| null, f: () => U): T \| U {
		return nullable == null ? f() : nullable;
		}

		/** Returns a function that returns the specified value or, if the value is
		* null or undefined, calls the provided callback and returns the result of
		* that function call.
		*
		* Useful as an alternative to {@link defaultValueFn} if the default value is
		* expensive to compute. */
		export function mapNullFn<T, U = T>(f: () => U): (nullable: T \| undefined \| null) => T \| U {
		return nullable => mapNull(nullable, f);
		}

@softwareventures/nullable - npm Package Compare versions

Worsened metrics

Dependency changes