简单的流程控制库:seq

项目地址

缘由

开发该项目主要起因有如下两点:

  1. 曾经在面试中被问到过,当时聊得挺好,建立了基本得模型,但一直没真正实现
  2. 最近在写 mdx-ppt 开源项目的时候看到了一个类似的实现,所以想起来自己实现以下

类似的库叫 through

那么这个库是干什么的呢?简单描述一下需求就是:

我想要连续调用一系列的函数,他们有明确的先后顺序,而且上一个函数的返回值需要作为下一个函数的参数,这一系列方法可以是异步的也可以是同步的。

使用方法

安装

npm i seq-fns

yarn add seq-fns

使用

const seq = require('seq')

seq([
  x => x + 1,
  async x => x + 2,
  x => new Promise(resolve => setTimeout(() => resolve(x + 3), 500)),
])
  .run(1)
  .then(result => console.log(result))

// 7 (1 + 1 + 2 + 3)

你可以通过 add 方法动态增加处理函数

seq.add(x => x + 1)

seq 会根据传入函数的顺序依次执行,并且把上一次处理的结果作为下一个函数的参数传入,函数可以是同步的也可以是异步的,最终 run 方法都会返回的一个 promise 并返回调用结果

错误处理

seq([
  x => x + 1,
  x => {
    throw x
  },
])
  .run(1)
  .catch(err => console.log(err))

// 2

任何在执行过程中的报错都可以在返回的promise中被捕获,包括:

  • 同步 throw 的错误
  • promise reject 的错误
  • 异步方法 throw 的错误

roadmap

该项目更多的是一个玩具项目,有一些实现上的细节还是值得去尝试的,比如目前有几个想法:

  1. 多个参数的传递
  2. 回调形式的异步函数
  3. 写一些 benchmark 来对比同类型的库

以上就是这个项目的一些细节,有兴趣的小伙伴可以点一下 start,当然如果想自己也来玩一下,欢迎 fork。当然 PR 也是非常欢迎的 😂。

订阅技术周报