Added res.links(obj)

lib/response.js

@@ -40,6 +40,27 @@ res.status = function(code){
   return this;
 };
 
+/**
+ * Set Link header field with the given `links`.
+ *
+ * Examples:
+ *
+ *    res.links({
+ *      next: 'http://api.example.com/users?page=2',
+ *      last: 'http://api.example.com/users?page=5'
+ *    });
+ *
+ * @param {Object} links
+ * @return {ServerResponse}
+ * @api public
+ */
+
+res.links = function(links){
+  return this.set('Link', Object.keys(links).map(function(rel){
+    return '<' + links[rel] + '>; rel="' + rel + '"';
+  }).join(', '));
+};
+
 /**
  * Send a response.
  *

test/res.links.js

@@ -0,0 +1,19 @@
+
+var express = require('../')
+  , res = express.response;
+
+describe('res', function(){
+  describe('.links(obj)', function(){
+    it('should set Link header field', function(){
+      res.links({
+        next: 'http://api.example.com/users?page=2',
+        last: 'http://api.example.com/users?page=5'
+      });
+
+      res.get('link')
+      .should.equal(
+          '<http://api.example.com/users?page=2>; rel="next", '
+        + '<http://api.example.com/users?page=5>; rel="last"');
+    })
+  })
+})