Merge pull request #131 from koajs/add/throw-status-msg

Add/throw status msg

docs/api/context.md

@@ -128,6 +128,7 @@ Note: koa uses the [cookies](https://github.com/jed/cookies) module where option
 ```js
 this.throw(403)
 this.throw('name required', 400)
+this.throw(400, 'name required')
 this.throw('something exploded')
 ```
 

lib/context.js

@@ -44,18 +44,18 @@ module.exports = {
    *
    *    this.throw(403)
    *    this.throw('name required', 400)
+   *    this.throw(400, 'name required')
    *    this.throw('something exploded')
    *
-   * @param {String|Number} msg
+   * @param {String|Number} msg or status
-   * @param {Number} status
+   * @param {String|Number} msg or status
    * @api public
    */
 
   throw: function(msg, status){
-    // TODO: switch order... feels weird now that im used to express
     if ('number' == typeof msg) {
       var tmp = msg;
-      msg = http.STATUS_CODES[tmp];
+      msg = status || http.STATUS_CODES[tmp];
       status = tmp;
     }
 

test/context/throw.js

@@ -29,6 +29,20 @@ describe('ctx.throw(msg, status)', function(){
   })
 })
 
+describe('ctx.throw(status, msg)', function(){
+  it('should throw an error', function(done){
+    var ctx = context();
+
+    try {
+      ctx.throw(400, 'name required');
+    } catch (err) {
+      assert('name required' == err.message);
+      assert(400 == err.status);
+      done();
+    }
+  })
+})
+
 describe('ctx.throw(status)', function(){
   it('should throw an error', function(done){
     var ctx = context();