@monstermann/fn/dist/array/firstOrElse.js

A utility library for TypeScript.

import { dfdlT } from "@monstermann/dfdl";

//#region src/array/firstOrElse.ts
/**
* `firstOrElse(array, callback)`
*
* Returns the first element of `array`, or the result of calling `callback` with the array if the array is empty.
*
* ```ts
* firstOrElse([1, 2, 3, 4], (arr) => arr.length); // 1
* ```
*
* ```ts
* pipe(
*     [1, 2, 3, 4],
*     firstOrElse((arr) => arr.length),
* ); // 1
* ```
*/
const firstOrElse = dfdlT((target, orElse) => {
	return target[0] ?? orElse(target);
}, 2);

//#endregion
export { firstOrElse };