liuli-util

`asyncLimiting`

function asyncLimiting < T : (...args: any[]) => Promise<any> > ( fn : T , limit : number ) : T

包装一个异步函数为有限制并发功能的函数

@param:

fn 异步函数

@param:

limit 并发限制数量

@returns:

返回被包装后的限制并发功能的函数

`concatMap`

function concatMap < T : (...args: any[]) => Promise<any> > ( fn : T ) : T

将一个异步函数包装为具有时序的异步函数注: 该函数会按照调用顺序依次返回结果，后面的执行的调用（不是调用结果）需要等待前面的，此函数适用于异步函数的内里执行也必须保证顺序时使用，否则请使用 mergeMap 函数注: 该函数其实相当于调用 {@code asyncLimiting(fn, {limit: 1})} 函数例如即时保存文档到服务器，当然要等待上一次的请求结束才能请求下一次，不然数据库保存的数据就存在谬误了

@param:

fn 一个普通的异步函数

@returns:

包装后的函数

`debounce`

function debounce < T : (...args: any[]) => any , R : (...args: Parameters<T>) => Promise<ReturnType<T>> > ( fn : T , delay : number , init : any = null ) : R

函数去抖去抖 (debounce) 去抖就是对于一定时间段的连续的函数调用，只让其执行一次注: 包装后的函数如果两次操作间隔小于 delay 则不会被执行, 如果一直在操作就会一直不执行, 直到操作停止的时间大于 delay 最小间隔时间才会执行一次, 不管任何时间调用都需要停止操作等待最小延迟时间应用场景主要在那些连续的操作, 例如页面滚动监听, 包装后的函数只会执行最后一次注: 该函数第一次调用一定不会执行，第一次一定拿不到缓存值，后面的连续调用都会拿到上一次的缓存值。如果需要在第一次调用获取到的缓存值，则需要传入第三个参数 {@param init}，默认为 {@code undefined} 的可选参数注: 返回函数结果的高阶函数需要使用 {@see Proxy} 实现，以避免原函数原型链上的信息丢失

@param:

fn 真正需要执行的操作

@param:

delay 最小延迟时间，单位为 ms

@param:

init 初始的缓存值，不填默认为 {@see undefined}

@return:

包装后有去抖功能的函数。该函数是异步的，与需要包装的函数 {@param fn} 是否异步没有太大关联

`exhaustMap`

function exhaustMap < T : (...args: any[]) => Promise<any> > ( fn : T ) : (...args: Parameters<T>) => Promise<PromiseValue<ReturnType<T>> | void>

将一个异步函数包装为具有时序的异步函数注: 该函数会阻止的异步操作，非常类似于 asyncLimiting(1)，但不同之处在于它会直接抛弃掉并发的请求

@param:

fn 一个普通的异步函数

@returns:

包装后的函数

`mergeMap`

function mergeMap < T : (...args: any[]) => Promise<any> > ( fn : T ) : T

将一个异步函数包装为具有时序的异步函数注: 该函数会按照调用顺序依次返回结果，后面的调用的结果需要等待前面的，所以如果不关心过时的结果，请使用 switchMap 函数

@param:

fn 一个普通的异步函数

@returns:

包装后的函数

`switchMap`

function switchMap < T : (...args: any[]) => Promise<any> > ( fn : T ) : T

将一个异步函数包装为具有时序的异步函数注: 该函数会丢弃过期的异步操作结果，这样的话性能会稍稍提高（主要是响应比较快的结果会立刻生效而不必等待前面的响应结果）

@param:

fn 一个普通的异步函数

@returns:

包装后的函数

`throttle`

function throttle < T : (...args: any[]) => any , R : (...args: Parameters<T>) => Promise<ReturnType<T>> > ( fn : T , delay : number ) : R

函数节流节流 (throttle) 让一个函数不要执行的太频繁，减少执行过快的调用，叫节流类似于上面而又不同于上面的函数去抖, 包装后函数在上一次操作执行过去了最小间隔时间后会直接执行, 否则会忽略该次操作与上面函数去抖的明显区别在连续操作时会按照最小间隔时间循环执行操作, 而非仅执行最后一次操作注: 该函数第一次调用一定会执行，不需要担心第一次拿不到缓存值，后面的连续调用都会拿到上一次的缓存值注: 返回函数结果的高阶函数需要使用 {@see Proxy} 实现，以避免原函数原型链上的信息丢失

@param:

delay 最小间隔时间，单位为 ms

@param:

fn 真正需要执行的操作

@return:

包装后有节流功能的函数。该函数是异步的，与需要包装的函数 {@param fn} 是否异步没有太大关联