28 lines
719 B
TypeScript
28 lines
719 B
TypeScript
|
/**
|
||
|
|
* Constructs a function that will only invoke the first function passed to it
|
||
|
|
* concurrently. Once the function has been executed, the racer will be reset
|
||
|
|
* and the next invocation will be allowed to execute.
|
||
|
|
*
|
||
|
|
* Example:
|
||
|
|
*
|
||
|
|
* ```ts
|
||
|
|
* import {createRace} from 'thingies/es2020/createRace';
|
||
|
|
*
|
||
|
|
* const race = createRace();
|
||
|
|
*
|
||
|
|
* race(() => {
|
||
|
|
* race(() => {
|
||
|
|
* console.log('This will not be executed');
|
||
|
|
* });
|
||
|
|
* console.log('This will be executed');
|
||
|
|
* });
|
||
|
|
*
|
||
|
|
* race(() => {
|
||
|
|
* console.log('This will be executed');
|
||
|
|
* });
|
||
|
|
* ```
|
||
|
|
*
|
||
|
|
* @returns A "race" function that will only invoke the first function passed to it.
|
||
|
|
*/
|
||
|
|
export declare const createRace: () => <T>(fn: () => T) => T | undefined;
|