What is this?

A higher-order function to provide a Feature Flag mechanism.

How do I install it?

npm install conditional-fn

How can I use it?

Use-case #1 - Simple Feature Flag (Boolean)

import { conditional } from 'conditional-fn';

const shouldICallFnA = true;

const fnToCall = conditional(
  () => console.log('fnA'),
  () => console.log('fnB'),
  shouldICallFnA
)

fnToCall(); // logs 'fnA'

Use-case #2 - Simple Feature Flag (Function)

import { conditional } from 'conditional-fn';

const shouldICallFnA = (str) => str === 'fnB';

const fnToCall = conditional(
  (str) => console.log('fnA'),
  (str) => console.log('fnB'),
  shouldICallFnA
)

fnToCall(); // logs 'fnB'

API

The conditional function accepts three arguments: two functions and a boolean or a function that returns a boolean. The function will return one of the provided functions based on the boolean or the function that returns a boolean.
The function as the third parameter (The conditional one) will be called with the arguments that were passed to the returned function.

Tests

You can run the tests by using the following command:

npm test