在 Web 开发中，经常会遇到需要将请求转发至其他服务器的情况。虽然可以使用一些 Node.js 工具来实现，但这些方案可能过于繁琐且不够灵活。因此，使用 ibird-forward 包可以更加简单、灵活，而且能够处理更多的情况。
本文将介绍如何使用 npm 包 ibird-forward 来进行请求转发。首先，我们需要安装 ibird-forward 包：
$ npm install ibird-forward --save
基本用法
ibird-forward 具有很好的可拓展性，可以自定义规则匹配、响应转换等，但其最基本的使用方法是简单的一行代码：
app.use(require('ibird-forward')());
这样配置后，所有请求都将被转发到默认的规则设置下。该规则设置包括：
- 匹配规则：任何请求都可以匹配；
- 目标地址：空。
也就是说，如果设置如上代码，则所有请求都会被转发到空地址。我们需要指定目标地址来更好的进行使用。
更改规则配置
要更改规则配置，可以使用 ibird-forward 返回的函数，该返回函数将包含一个 Object 类型的参数，这个参数就是规则设置对象。比如要设置转发规则，将 localhost:8888 上的所有请求转发到 localhost:9999 上：
app.use(require('ibird-forward')({ rules: [ { match: /^.*$/, target: 'http://localhost:9999' } ] }));
这样，访问 http://localhost:8888，就会转发到 http://localhost:9999。如果你要转发到多个目标地址，可以使用一个数组：
app.use(require('ibird-forward')({ rules: [ { match: /^.*$/, target: ['http://localhost:9999', 'http://localhost:9998'] } ] }));
这将会按顺序进行请求转发，如果第一个目标地址失败，则会继续向下转发，直到找到成功的转发地址。
使用 match 参数，可以设置匹配规则。match 参数可以是正则表达式，也可以是一个返回 true/false 的函数：
app.use(require('ibird-forward')({ rules: [ { match: /^.*\.png$/, target: 'http://localhost:9999' } ] }));
这样，只有后缀为 png 的请求才会被转发至目标地址。
自定义请求头
有时，转发请求需要自定义请求头。此时，你可以使用 headers 参数来进行配置：
-- -------------------- ---- ------- ---------------------------------- ------ - - ------ ------- ------- ------------------------ -------- - ------------------ ----------- - - - ----展开代码
这样，转发的请求将会包含自定义请求头 X-Forwarded-For: localhost。
修改响应体
有时，我们需要对请求返回的响应体进行修改，这可以使用 transformResponse 参数来实现：
-- -------------------- ---- ------- --- - ------ -------- --------- - -------- --------------- --- -- -------- --------------------------- - -------------------------------- - ------------- ------ ------------- - ------ ---- -------- - ---------------------------------- ------ - - ------ ------------ ------- ------------------------ ------------------ ----------------- - - ----展开代码
这个例子会将转发请求返回的响应体设置为 text/plain 格式，并且在响应体末尾添加 I love ibird!。
支持的所有参数
一般来说，ibird-forward 包已经为常用场景提供了方便的缺省值，但如果需要更加灵活的控制，你可以详细了解支持的参数。
以下列出 ibird-forward 支持的所有参数：
| 参数 | 类型 | 描述 |
|---|---|---|
| rules | Array | 规则列表 |
| rules[].match | RegExp/Function | 匹配规则 |
| rules[].target | String/Array | 转发目标地址 |
| rules[].headers | Object | 自定义请求头 |
| rules[].filter | Function | 自定义过滤器 |
| rules[].options | Object | 转发请求的 Axios 配置项（axios 所有配置项均可） |
| transform | Function | 同 transformResponse，兼容老版本函数名 |
| transformResponse | Function | 响应体处理函数 |
| log | Object | 日志记录配置 |
| error | Object | 错误处理配置 |
| fallback | Boolean/String | 当转发请求错误时，是否执行其余路由 |
总结
使用 ibird-forward 包，可以轻松地将请求转发到其他地址，在需要搭建前端代理服务器时，是一个十分有用的解决方案。ibird-forward 并不光止于基本的使用，还提供了灵活的可拓展性，使用者可以根据自己的需求进行快速搭建和配置。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005725581e8991b448e8697
