rc-js-util/src/array/impl/array-normalize-nullish-to-empty.ts

A collection of TS and C++ utilities to help writing performant and correct applications, achieved through strict typing and (removable) invariant checking.

/**
 * @public
 * Replaces `null` / `undefined` with an empty `Array`.
 * @returns `array` if it's an `Array` of length greater than 0, otherwise an empty `Array`.
 *
 * @remarks
 * See {@link arrayNormalizeNullishToEmpty}.
 */
export function arrayNormalizeNullishToEmpty<TItem>(array: TItem[] | null | undefined): TItem[]
{
    if (array == null)
    {
        return [];
    }

    return array;
}