Function before

Alias

before<F>(n, func): ((...args: Parameters<F>) => ReturnType<F> | undefined)
Creates a function that limits the number of times the given function (func) can be called.
Type Parameters
- F extends ((...args: any[]) => any)
  The type of the function to be invoked.
Parameters
- n: number
  The number of times the returned function is allowed to call func before stopping.
  - If n is 0, func will never be called.
  - If n is a positive integer, func will be called up to n-1 times.
- func: F
  The function to be called with the limit applied.
Returns ((...args: Parameters<F>) => ReturnType<F> | undefined)
- A new function that:
- Tracks the number of calls.
- Invokes func until the n-1-th call.
- Returns undefined if the number of calls reaches or exceeds n, stopping further calls.
- - (...args): ReturnType<F> | undefined
  - Parameters
    - Rest...args: Parameters<F>
    Returns ReturnType<F> | undefined
Throws
- Throw an error if n is negative.
Example
```
const beforeFn = before(3, () => {
 console.log("called");
})

// Will log 'called'.
beforeFn();

// Will log 'called'.
beforeFn();

// Will not log anything.
beforeFn();
```
- Defined in src/function.ts:23