add ctx.remove() and res.remove(). Closes #100

docs/api/context.md

@@ -62,6 +62,7 @@
   - `ctx.redirect()`
   - `ctx.attachment()`
   - `ctx.set()`
+  - `ctx.remove()`
   - `ctx.lastModified=`
   - `ctx.etag=`
 

docs/api/response.md

@@ -159,6 +159,10 @@ this.set({
 });
 ```
 
+### res.remove(field)
+
+  Remove header `field`.
+
 ### res.type
 
   Get response `Content-Type` void of parameters such as "charset".

lib/context.js

@@ -395,6 +395,14 @@ module.exports = {
     this.response.etag = val;
   },
 
+  /**
+   * Delegate to Request#remove().
+   */
+
+  remove: function() {
+    return this.response.remove.apply(this.response, arguments);
+  },
+
   /**
    * Delegate to Request#accepts().
    */

lib/request.js

@@ -561,19 +561,19 @@ module.exports = {
    *     this.get('Something');
    *     // => undefined
    *
-   * @param {String} name
+   * @param {String} field
    * @return {String}
    * @api public
    */
 
-  get: function(name){
+  get: function(field){
     var req = this.req;
-    switch (name = name.toLowerCase()) {
+    switch (field = field.toLowerCase()) {
       case 'referer':
       case 'referrer':
         return req.headers.referrer || req.headers.referer;
       default:
-        return req.headers[name];
+        return req.headers[field];
     }
   },
 

lib/response.js

@@ -347,13 +347,13 @@ module.exports = {
    *     this.get('content-type');
    *     // => "text/plain"
    *
-   * @param {String} name
+   * @param {String} field
    * @return {String}
    * @api public
    */
 
-  get: function(name){
-    return this.header[name.toLowerCase()];
+  get: function(field){
+    return this.header[field.toLowerCase()];
   },
 
   /**
@@ -383,6 +383,17 @@ module.exports = {
     }
   },
 
+  /**
+   * Remove header `field`.
+   *
+   * @param {String} name
+   * @api public
+   */
+
+  remove: function(field){
+    this.res.removeHeader(field);
+  },
+
   /**
    * Append `val` to header `field`.
    *

test/context.js

@@ -8,6 +8,7 @@ exports = module.exports = function(req, res){
   req = req || { headers: {} };
   res = res || { _headers: {} };
   res.setHeader = function(k, v){ res._headers[k.toLowerCase()] = v };
+  res.removeHeader = function(k, v){ delete res._headers[k.toLowerCase()] };
   return koa().createContext(req, res);
 }
 

test/response/remove.js

@@ -0,0 +1,11 @@
+
+var context = require('../context');
+
+describe('ctx.remove(name)', function(){
+  it('should remove a field', function(){
+    var ctx = context();
+    ctx.set('x-foo', 'bar');
+    ctx.remove('x-foo');
+    ctx.response.header.should.eql({});
+  })
+})