TheThing/koa-lite
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

docs: cleanup middleware guide, including TJ's yoda-style conditionals

Browse source 
changes on top of 789c30f926. closes
#158, closes #157
This commit is contained in:
Jonathan Ong 2013-12-30 22:20:32 -08:00
parent 789c30f926
commit 26f0d16644
1 changed files with 11 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
docs/guide.md
View file

@ -118,15 +118,13 @@ function logger(format){
}
```
### Adding multiple middleware at once
### Combining multiple middleware
To add multiple middleware at once chain them together with
[.call()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/call)
and then return another function that yields the chain.
Sometimes you want to "compose" multiple middleware into a single middleware for easy re-use or exporting. To do so, you may chain them together with `.call(this, next)`s, then return another function that yields the chain.
```js
function *random(next){
if (this.path == '/random') {
if ('/random' == this.path) {
this.body = Math.floor(Math.random()*10);
} else {
yield next;
@ -134,7 +132,7 @@ function *random(next){
};
function *backwords(next) {
if (this.path == '/backwords') {
if ('/backwords' == this.path) {
this.body = 'sdrowkcab';
} else {
yield next;
@ -142,18 +140,22 @@ function *backwords(next) {
}
function *pi(next){
if (this.path == '/pi') {
if ('/pi' == this.path) {
this.body = String(Math.PI);
} else {
yield next;
}
}
app.use(function*(next){
function *all(next) {
yield random.call(this, backwords.call(this, pi.call(this, next)));
});
}
app.use(all);
```
This is exactly what [koa-compose](https://github.com/koajs/compose) does, which Koa internally uses to create and dispatch the middleware stack.
### Response Middleware
Middleware that decide to respond to a request and wish to bypass downstream middleware may