feat(router): add ignoreTrailingSlash router option (#1632)

Author: delvedor

lib/router.js

@@ -33,12 +33,18 @@ var ResourceNotFoundError = errors.ResourceNotFoundError;
  * @param {Boolean} [options.strictNext=false] - Throws error when next() is
  *  called more than once, enabled onceNext option
  * @param {Object} [options.registry] - route registry
+ * @param {Object} [options.ignoreTrailingSlash] - ignore trailing slash on
+ *  paths
  */
 function Router(options) {
     assert.object(options, 'options');
     assert.object(options.log, 'options.log');
     assert.optionalBool(options.onceNext, 'options.onceNext');
     assert.optionalBool(options.strictNext, 'options.strictNext');
+    assert.optionalBool(
+        options.ignoreTrailingSlash,
+        'options.ignoreTrailingSlash'
+    );
 
     EventEmitter.call(this);
 

lib/routerRegistryRadix.js

@@ -9,9 +9,12 @@ var Chain = require('./chain');
  *
  * @class RouterRegistryRadix
  * @public
+ * @param  {Object} options - an options object
+ * @param {Object} [options.ignoreTrailingSlash] - ignore trailing slash on
+ *  paths
  */
-function RouterRegistryRadix() {
-    this._findMyWay = new FindMyWay();
+function RouterRegistryRadix(options) {
+    this._findMyWay = new FindMyWay(options);
     this._routes = {};
 }
 

test/router.test.js

@@ -346,3 +346,28 @@ test('toString()', function(t) {
     );
     t.end();
 });
+
+test('toString() with ignoreTrailingSlash', function(t) {
+    function handler(req, res, next) {
+        res.send('Hello world');
+    }
+
+    var router = new Router({
+        log: {},
+        ignoreTrailingSlash: true
+    });
+    router.mount({ method: 'GET', path: '/' }, [handler]);
+    router.mount({ method: 'GET', path: '/a' }, [handler]);
+    router.mount({ method: 'GET', path: '/a/b' }, [handler]);
+    router.mount({ method: 'POST', path: '/' }, [handler]);
+
+    t.deepEqual(
+        router.toString(),
+        '└── / (GET|POST)\n' +
+            '    └── a (GET)\n' +
+            '        └── / (GET)\n' +
+            '            └── b (GET)\n' +
+            '                └── / (GET)\n'
+    );
+    t.end();
+});

test/routerRegistryRadix.test.js

@@ -99,3 +99,21 @@ test('toString()', function(t) {
     );
     t.end();
 });
+
+test('toString() with ignoreTrailingSlash', function(t) {
+    var registry = new RouterRegistryRadix({ ignoreTrailingSlash: true });
+    registry.add(getTestRoute({ method: 'GET', path: '/' }));
+    registry.add(getTestRoute({ method: 'GET', path: '/a' }));
+    registry.add(getTestRoute({ method: 'GET', path: '/a/b' }));
+    registry.add(getTestRoute({ method: 'POST', path: '/' }));
+
+    t.deepEqual(
+        registry.toString(),
+        '└── / (GET|POST)\n' +
+            '    └── a (GET)\n' +
+            '        └── / (GET)\n' +
+            '            └── b (GET)\n' +
+            '                └── / (GET)\n'
+    );
+    t.end();
+});

test/server.test.js

@@ -46,7 +46,8 @@ before(function(cb) {
             dtrace: helper.dtrace,
             handleUncaughtExceptions: true,
             log: helper.getLog('server'),
-            version: ['2.0.0', '0.5.4', '1.4.3']
+            version: ['2.0.0', '0.5.4', '1.4.3'],
+            ignoreTrailingSlash: true
         });
         SERVER.listen(PORT, '127.0.0.1', function() {
             PORT = SERVER.address().port;
@@ -159,6 +160,85 @@ test('get (path only)', function(t) {
     });
 });
 
+test('get (path only - with trailing slash)', function(t) {
+    SERVER.get('/foo/', function echoId(req, res, next) {
+        res.send();
+        next();
+    });
+
+    var count = 0;
+
+    CLIENT.get('/foo/', function(err, _, res) {
+        t.ifError(err);
+        t.equal(res.statusCode, 200);
+
+        if (++count === 2) {
+            t.end();
+        }
+    });
+
+    CLIENT.get('/foo', function(err, _, res) {
+        t.ifError(err);
+        t.equal(res.statusCode, 200);
+
+        if (++count === 2) {
+            t.end();
+        }
+    });
+});
+
+test('get (path only - with trailing slash and nested route)', function(t) {
+    SERVER.get('/foo/', function echoId(req, res, next) {
+        res.statusCode = 200;
+        res.send();
+        next();
+    });
+
+    SERVER.get('/foo/bar', function echoId(req, res, next) {
+        res.statusCode = 201;
+        res.send();
+        next();
+    });
+
+    var count = 0;
+
+    CLIENT.get('/foo/', function(err, _, res) {
+        t.ifError(err);
+        t.equal(res.statusCode, 200);
+
+        if (++count === 4) {
+            t.end();
+        }
+    });
+
+    CLIENT.get('/foo', function(err, _, res) {
+        t.ifError(err);
+        t.equal(res.statusCode, 200);
+
+        if (++count === 4) {
+            t.end();
+        }
+    });
+
+    CLIENT.get('/foo/bar/', function(err, _, res) {
+        t.ifError(err);
+        t.equal(res.statusCode, 201);
+
+        if (++count === 4) {
+            t.end();
+        }
+    });
+
+    CLIENT.get('/foo/bar', function(err, _, res) {
+        t.ifError(err);
+        t.equal(res.statusCode, 201);
+
+        if (++count === 4) {
+            t.end();
+        }
+    });
+});
+
 test('use + get (path only)', function(t) {
     SERVER.use(function(req, res, next) {
         next();