emptyOrNull

Normalizes missing and empty values to null. It treats null, undefined, empty arrays, and strings that are blank after trimming as empty, and returns everything else untouched.

Use it when downstream code should work with one empty sentinel instead of the several shapes JavaScript uses to mean "nothing".

Importing

import { emptyOrNull } from '@almighty-shogun/utils';

Usage

import { emptyOrNull } from '@almighty-shogun/utils';

emptyOrNull('project');       // 'project'
emptyOrNull('');              // null
emptyOrNull('   ');           // null
emptyOrNull([1, 2]);          // [1, 2]
emptyOrNull([]);              // null
emptyOrNull(null);            // null
emptyOrNull(undefined);       // null
emptyOrNull(0);               // 0
emptyOrNull(false);           // false

Parameters

value: NullableOrUndefinable<T>
Value to normalize.

Returns

The original value, or null when the value is null, undefined, an empty array, or a blank string.

Uses

• Nullable
• NullableOrUndefinable

Type signature

declare function emptyOrNull<T>(
    value: NullableOrUndefinable<T>
): Nullable<T>;