Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gyson/koa-simple-router
Simple router for koa 2.x
https://github.com/gyson/koa-simple-router
Last synced: about 2 months ago
JSON representation
Simple router for koa 2.x
- Host: GitHub
- URL: https://github.com/gyson/koa-simple-router
- Owner: gyson
- License: mit
- Created: 2015-10-29T05:11:38.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2015-11-17T18:14:24.000Z (about 9 years ago)
- Last Synced: 2024-10-05T01:19:08.677Z (2 months ago)
- Language: JavaScript
- Homepage:
- Size: 26.4 KB
- Stars: 11
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-koa - koa-simple-router - 简单快速的 REST 路由中间件（支持koa 2.x）   (仓库 / 中间件)
README
# koa-simple-router
[](https://npmjs.org/package/koa-simple-router)
[](https://travis-ci.org/gyson/koa-simple-router)
Simple and fast router for [koa](https://github.com/koajs/koa) 2.x
## Features
* support prefix
* support auto OPTIONS and 405 response
* use [`path-to-regexp`](https://github.com/pillarjs/path-to-regexp) to parse url
* use express style routing ( `.get`, `.put`, `.post`, `.all`, etc )
* use loop to iterate through multiple routes instead of recursive calls
* better performance
* prevent max call stack error with large number of routes
## Installation
```
$ npm install koa-simple-router
```
## Usage
```js
const Koa = require('koa') // koa 2.x
const router = require('koa-simple-router')
let app = new Koa()
app.use(router(_ => {
_.get('/', (ctx, next) => {
ctx.body = 'hello'
})
_.post('/name/:id', (ctx, next) => {
// ...
})
})
```
## API
### `router(init)`
Create a router middleware with init function.
```js
const Koa = require('koa')
const router = require('koa-simple-router')
const app = new Koa()
app.use(router(_ => {
_.get('/', (ctx, next) => {
})
_.post('/path', (ctx, next) => {
})
}))
```
### `router(options, init)`
Create a router middleware with options and init function.
Default options is the same as [`path-to-regexp`](https://github.com/pillarjs/path-to-regexp).
- **prefix** (default: `null`)
- **sensitive** (default: `false`)
- **strict** (default: `false`)
- **end** (default: `true`)
```js
const Koa = require('koa')
const router = require('koa-simple-router')
const app = new Koa()
app.use(router({ prefix: '/api' }, _ => {
_.get('/:user/id', (ctx, next) => {
})
_.post('/:user/id', (ctx, next) => {
})
}))
```
### `_.verb(path, ...mw)`
```js
app.use(router(_ => {
_.get('/path',
(ctx, next) => {},
(ctx, next) => {},
(ctx, next) => {}
)
}))
```
### `_.all(path, ...[mw | obj])`
Middleware mode: works just like `_.verb(path, ...mw)` but ignore `ctx.method`
```js
app.use(router(_ => {
_.all('/path/to/:recource', (ctx, next) => {
})
}))
```
Object mode: accept an object with method as key and middleware or array of middleware as value
* auto `HEAD` response if `GET` present
* auto `OPTIONS` response with `Allow` header
* auto 405 response with `Allow` header
```js
app.use(router(_ => {
_.all('/path/to/:recource', {
get: (ctx, next) => {
// ...
},
post: (ctx, next) => {
// ...
},
put: (ctx, next) => {
// ...
},
delete: (ctx, next) => {
// ...
}
// Allow: GET, HEAD, POST, PUT, DELETE, OPTIONS
})
}))
```
which is equivalent to
```js
app.use(router(_ => {
_.all('/path/to/:recource', (ctx, next) => {
switch (ctx.method) {
case 'GET':
case 'HEAD':
// ...
break
case 'POST':
// ...
break
case 'PUT':
// ...
break
case 'DELETE':
// ...
break
case 'OPTIONS':
ctx.status = 200
ctx.set('Allow', 'GET, HEAD, POST, PUT, DELETE, OPTIONS')
break
default:
ctx.status = 405 // method not allowed
ctx.set('Allow', 'GET, HEAD, POST, PUT, DELETE, OPTIONS')
}
}
}))
```
### `_.param(param, ...mw)`
Register middleware for named route parameters.
```js
app.use(router(_ => {
_.param('user', async (ctx, next) => {
ctx.user = await User.find(ctx.params.user)
// ...
return next()
})
_.get('/:user/do-x', (ctx, next) => {
})
_.post('/:user/do-y', (ctx, next) => {
})
}))
```
## License
MIT