README.md

koa-path-mapping

Koa middleware for redirect or path rewrite of requests. Support path rewrite of failed requests.
用于对请求进行重定向或路径重写的 koa 中间件，支持对失败的请求进行路径重写。

允许对 404 请求进行路径重写，并回退到 next()，对于以下场景非常有用：

• 使用 HTML5 History API 的单页应用和多页应用
• 使用 webpack-dev-middleware 的开发服务器，例如 webpack-serve

起步

安装

npm install --save-dev koa-path-mapping

用法

const Koa = require('koa');
const pathMappingMiddleware = require('koa-path-mapping').pathMappingMiddleware;

const app = new Koa();
const options = {
    mapping: [
        { action: 'redirect', from: '^/$', to: '/login' },
        { action: 'rewrite', from: '^/game($|/)', to: '/app-game.html' },
    ],
    error: [{ action: 'rewrite', status: 404, to: '/app.html' }],
};
app.use(pathMappingMiddleware(options));

API

pathMappingMiddleware(options: PathMappingOptions)

PathMappingOptions

创建中间件的选项。

PathMappingOptions.mapping

类型: MappingOptions[]
默认: []
参考

PathMappingOptions.error

类型: ErrorOptions[]
默认: []
参考

PathMappingOptions.ignoreJson

类型: boolean
默认: true
是否忽略 application/json 的请求。

PathMappingOptions.enableLog

类型: boolean
默认: false
是否输出日志。

PathMappingOptions.logger

类型: Function
默认: console.log
设置输出日志所使用的函数。

---

MappingOptions

对请求进行重定向或路径重写，在进入时执行。

MappingOptions.action

类型: 'redirect' | 'rewrite'
设置执行的动作，必填。

MappingOptions.from

类型: RegExp | string
设置匹配的 path，如果未设置，则匹配所有的请求。值要求为 RegExp 实例，或是 RegExp 格式的字符串。

MappingOptions.to

类型: string
设置目标的 path，必填。

---

ErrorOptions

对失败的请求进行重定向或路径重写，在 next() 之后执行。如果匹配成功并执行路径重写，那么会再一次执行 next()。

ErrorOptions.action

类型: 'redirect' | 'rewrite'
设置执行的动作，必填。

ErrorOptions.status

类型: number
设置匹配的状态码，如果未设置，则匹配 status >= 400。

ErrorOptions.from

类型: RegExp | string
设置匹配的 path，如果未设置，则匹配所有的请求。值要求为 RegExp 实例，或是 RegExp 格式的字符串。

ErrorOptions.to

类型: string
设置目标的 path，必填。

License

MIT