parent
ac08965988
commit
2bc3bb7327
3 changed files with 33 additions and 0 deletions
|
@ -102,6 +102,12 @@ throw err;
|
||||||
error messages since you do not want to leak failure
|
error messages since you do not want to leak failure
|
||||||
details.
|
details.
|
||||||
|
|
||||||
|
### ctx.respond
|
||||||
|
|
||||||
|
To bypass Koa's built-in response handling, you may explicitly set `this.respond = false;`. Use this if you want to write to the raw `res` object instead of letting Koa handle the response for you.
|
||||||
|
|
||||||
|
Note that using this is __not__ supported by Koa. This may break intended functionality of Koa middleware and Koa itself. Using this properly is considered a hack and is only a convenience to those wishing to use traditional `fn(req, res)` functions and middleware within Koa.
|
||||||
|
|
||||||
## Request aliases
|
## Request aliases
|
||||||
|
|
||||||
The following accessors and alias [Request](request.md) equivalents:
|
The following accessors and alias [Request](request.md) equivalents:
|
||||||
|
|
|
@ -184,6 +184,8 @@ function *respond(next){
|
||||||
|
|
||||||
yield *next;
|
yield *next;
|
||||||
|
|
||||||
|
if (false === this.respond) return;
|
||||||
|
|
||||||
var res = this.res;
|
var res = this.res;
|
||||||
if (res.headersSent || !res.socket.writable) return;
|
if (res.headersSent || !res.socket.writable) return;
|
||||||
|
|
||||||
|
|
|
@ -94,6 +94,31 @@ describe('app.use(fn)', function(){
|
||||||
})
|
})
|
||||||
|
|
||||||
describe('app.respond', function(){
|
describe('app.respond', function(){
|
||||||
|
describe('when this.respond === false', function(){
|
||||||
|
it('should bypass app.respond', function(done){
|
||||||
|
var app = koa();
|
||||||
|
|
||||||
|
app.use(function *(){
|
||||||
|
this.body = 'Hello';
|
||||||
|
this.respond = false;
|
||||||
|
|
||||||
|
var res = this.res;
|
||||||
|
setImmediate(function () {
|
||||||
|
res.setHeader('Content-Type', 'text/plain');
|
||||||
|
res.end('lol');
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
var server = app.listen();
|
||||||
|
|
||||||
|
request(server)
|
||||||
|
.get('/')
|
||||||
|
.expect(200)
|
||||||
|
.expect('lol')
|
||||||
|
.end(done);
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
describe('when HEAD is used', function(){
|
describe('when HEAD is used', function(){
|
||||||
it('should not respond with the body', function(done){
|
it('should not respond with the body', function(done){
|
||||||
var app = koa();
|
var app = koa();
|
||||||
|
|
Loading…
Reference in a new issue