Conditional Functions

Functions that take in two parameters. a boolean and a callback. When the condition is true or not it executes the function that was passed through. If not it will instead not call the function. The two functions presented below are functions that do the same thing in reverse.

Execute If

    executeIf<T extends Callback>(condition: boolean,
        cb: T
    ): ReturnType<T> | null

A conditional function that will execute the callback passed to it. If the condition is true.

Usage

The below function will execute.

 const fruits = ['Apple', 'Strawberry']

 {executeIf(!fruits.includes("Apple"), ()=> 'Not a fruit'))}

Execute Unless

    executeUnless<T extends Callback>(condition: boolean,
     cb: T
    ): ReturnType<T> | null

A conditional function that will execute the callback passed to it. If the condition is not true.

Usage

The below function will not execute.

 const fruits = ['Apple', 'Strawberry']

 {executeUnless(fruits.includes("Strawberry"), ()=> 'Not a fruit'))}

Execute If Else

A conditional function that executes one function if a condition is true another one if a condition is false. It's an overload that can either take an object or three parameters.

type IfElseOptions = {
  condition: boolean;
  ifCb: (...args: Array<unknown>) => NonNullable<unknown>;
  elseCb: (...args: Array<unknown>) => NonNullable<unknown>;
};

function executeIfElse(
  options: IfElseOptions,
): ReturnType<typeof options.ifCb> | ReturnType<typeof options.elseCb>;

function executeIfElse(
  condition: boolean,
  ifCb: IfElseOptions['ifCb'],
  elseCb: IfElseOptions['elseCb'],
): ReturnType<typeof ifCb> | ReturnType<typeof elseCb>;

const fruits = ['Apple', 'Strawberry'];

{
  executeIfElse(
    fruits.includes('Strawberry'),
    () => 'Is a fruit',
    () => 'Not a fruit',
  );
}

const fruits = ['Apple', 'Strawberry'];

{
  executeIfElse({
    condition: fruits.includes('Apple'),
    ifCb: () => 'Is a fruit',
    elseCb: () => 'Not a fruit',
  });
}