Add fallbackFile option to response for unhandled requests

Author: ngs

README.md

@@ -55,6 +55,13 @@ To allow fall through to your custom routes:
 ecstatic({ root: __dirname + '/public', handleError: false })
 ```
 
+### fallback file
+To response with specified file:
+
+```js
+ecstatic({ root: __dirname + '/public', fallbackFile: 'index.html' })
+```
+
 # API:
 
 ## ecstatic(opts);
@@ -74,14 +81,15 @@ var opts = {
              gzip          : false,
              serverHeader  : true,
              contentType   : 'application/octet-stream',
-             mimeTypes     : undefined
+             mimeTypes     : undefined,
+             fallbackFile  : undefined
            }
 ```
 
 If `opts` is a string, the string is assigned to the root folder and all other
 options are set to their defaults.
 
-### `opts.root` 
+### `opts.root`
 
 `opts.root` is the directory you want to serve up.
 
@@ -145,7 +153,7 @@ Defaults to **application/octet-stream**.
 
 Add new or override one or more mime-types. This affects the HTTP Content-Type header.
 Can either be a path to a [`.types`](http://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types) file or an object hash of type(s).
-    
+
     ecstatic({ mimeType: { 'mime-type': ['file_extension', 'file_extension'] } })
 
 ### `opts.handleError`

lib/ecstatic.js

@@ -26,7 +26,8 @@ var ecstatic = module.exports = function (dir, options) {
       baseDir = opts.baseDir,
       defaultExt = opts.defaultExt,
       handleError = opts.handleError,
-      serverHeader = opts.serverHeader;
+      serverHeader = opts.serverHeader,
+      fallbackFile = opts.fallbackFile;
 
   opts.root = dir;
   if (defaultExt && /^\./.test(defaultExt)) defaultExt = defaultExt.replace(/^\./, '');
@@ -98,6 +99,11 @@ var ecstatic = module.exports = function (dir, options) {
               url: parsed.pathname + '.' + defaultExt + ((parsed.search)? parsed.search:'')
             }, res, next);
           }
+          else if (fallbackFile) {
+            middleware({
+              url: ('/' + path.join(baseDir, fallbackFile))
+            }, res, next);
+          }
           else {
             // Try to serve default ./404.html
             middleware({

lib/ecstatic/opts.js

@@ -12,6 +12,7 @@ module.exports = function (opts) {
       handleError = true,
       serverHeader = true,
       contentType = 'application/octet-stream',
+      fallbackFile,
       mimeTypes;
 
   function isDeclared(k) {
@@ -87,6 +88,17 @@ module.exports = function (opts) {
       }
     });
 
+    [
+      'fallbackFile',
+      'fallbackfile',
+      'fallback-file'
+    ].some(function (k) {
+      if (isDeclared(k)) {
+        fallbackFile = opts[k];
+        return true;
+      }
+    });
+
     [
       'serverHeader',
       'serverheader',
@@ -137,6 +149,7 @@ module.exports = function (opts) {
     baseDir: (opts && opts.baseDir) || '/',
     gzip: gzip,
     handleError: handleError,
+    fallbackFile: fallbackFile,
     serverHeader: serverHeader,
     contentType: contentType,
     mimeTypes: mimeTypes

test/custom-fallback-file.js

@@ -0,0 +1,29 @@
+var test = require('tap').test,
+    http = require('http'),
+    request = require('request'),
+    ecstatic = require('../');
+
+test('custom fallbackFile', function(t) {
+  try {
+    var server = http.createServer(ecstatic({
+      root: __dirname + '/public/',
+      fallbackFile: 'a.txt'
+    }));
+  } catch (e) {
+    t.fail(e.message);
+    t.end();
+  }
+
+  t.plan(4);
+
+  server.listen(0, function() {
+    var port = server.address().port;
+    request.get('http://localhost:' + port + '/file-not-found', function(err, res, body) {
+      t.ifError(err);
+      t.equal(res.statusCode, 200, 'status code should be ok');
+      t.equal(res.headers['content-type'], 'text/plain; charset=UTF-8');
+      server.close(function() { t.end(); });
+      t.equal('A!!!\n', body);
+    });
+  });
+});