koa-66 v1.0.1
koa-66
Router middleware for koa v2.
feedbacks are welcome
Features
- Plugin middleware support
- Express like http verbs methods (including
all
) - Express like use function
- Express like param function
- Automatic OPTIONS response
- Automatic HEAD when GET is present
- 501 and 405 status (throw capability with headers)
- Mount instance on specific path
- Multiple middleware as arguments
- Multiple middleware as array
Installation
# with npm
$ npm install koa-66
$ with yarn
$ yarn add koa-66
Example
const Koa = require('koa');
const Router = require('koa-66');
const app = new Koa();
const router = new Router();
const mainRouter = new Router();
router.param('id', (ctx, next, id) => {
ctx.yolo = id;
return next();
});
router.use(async function(ctx, next) {
ctx.a = " ";
await next();
});
router.get('/:id', (ctx, next) => {
return next().then(() => {
ctx.body += ctx.a + ctx.yolo;
})
});
router.get('/:id', async function(ctx) {
ctx.body = await Promise.resolve('hello');
});
mainRouter.mount('/pouet', router);
app.use(mainRouter.routes());
app.listen(1664);
// GET http://localhost:1664/pouet/world
// => hello world
Example with throw option
const Koa = require('koa');
const Router = require('koa-66');
const app = new Koa();
const router = new Router();
app.use(async function(ctx, next) {
try {
await next();
}catch(e){
if (e.status === 405) {
ctx.status = 405;
ctx.set(e.headers);
}
}
})
router.get('/', (ctx) => ctx.body = 'hello');
app.use(router.routes({throw: true}));
app.listen(1664);
// > curl http://localhost:1664/ -I -X POST
//
// HTTP/1.1 405 Method Not Allowed
// allow: HEAD, GET
// Content-Type: text/plain; charset=utf-8
// Content-Length: 18
// Date: Wed, 04 Nov 2015 10:29:06 GMT
// Connection: keep-alive
Plugin support
I don't know if Plugin is a good term for this feature. The goal was to add cappability to register some middleware on a main Router that will be inject via config object on different route. (ex: authentication or acl behaviour). Why? Because I am lazy to require some middleware in all my router script with generaly relatif path...
So I decided to add the possibility to inject an object at first parameter (that will be a config object) and adding an extra middleware that will be inject in middleware stack. To register this plugin just use a plugin()
method.
const Router = require('koa-66');
const main = new Router();
// you can use multiple middleware as arguments or array
main.plugin('authent', (ctx, next) => {
// pick plugin config object on ctx.state.plugins.
// here ctx.state.plugins.authent === true;
// do stuff inject user on context for example
return next();
//or throw or do nothing that will stop execution of router stack
})
main.plugin('acl', (ctx, next) => {
// here ctx.state.plugins.acl === ['admin'];
// do stuff check role via ctx.state.plugins.acl for example
return next();
//or throw or do nothing that will stop execution of router stack
})
const router = new Router();
router.use({authent: true});
//options here is a boolean,
//but you can pass everything you want,
//and it will be inject as options
router.get('/private', {acl:['admin']},
ctx => ctx.body = 'private'
)
main.mount('/api', router);
...
// order of call /api/private
// 1 plugin authent
// 2 plugin acl
// 3 real middleware
Test
# npm test
8 years ago
9 years ago
9 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago