Koa implementation of [connect-history-api-fallback](https://github.com/bripkens/connect-history-api-fallback)\n\n[](https://nodei.co/npm/koa-history-api-fallback/)\n\n## Introduction\n\nThis is simple rewrite of [connect-history-api-fallback](https://github.com/bripkens/connect-history-api-fallback)\n\n## Usage\n\nThe middleware is available through NPM and can easily be added.\n\n```\nnpm install --save koa-history-api-fallback\n```\n\nImport the library\n\n```javascript\nvar historyApiFallback = require('koa-history-api-fallback');\n\nvar app = koa();\n\napp.use(historyApiFallback());\n```\n\n## Options\nYou can optionally pass options to the library when obtaining the middleware\n\n```javascript\nvar middleware = historyApiFallback({});\n```\n\n### index\nOverride the index (default `/index.html`)\n\n```javascript\nhistoryApiFallback({\n index: '/default.html'\n});\n```\n\n### rewrites\nOverride the index when the request url matches a regex pattern. You can either rewrite to a static string or use a function to transform the incoming request.\n\nThe following will rewrite a request that matches the `/\\/soccer/` pattern to `/soccer.html`.\n```javascript\nhistoryApiFallback({\n rewrites: [\n { from: /\\/soccer/, to: '/soccer.html'}\n ]\n});\n```\n\nAlternatively functions can be used to have more control over the rewrite process. For instance, the following listing shows how requests to `/libs/jquery/jquery.1.12.0.min.js` and the like can be routed to `./bower_components/libs/jquery/jquery.1.12.0.min.js`. You can also make use of this if you have an API version in the URL path.\n```javascript\nhistoryApiFallback({\n rewrites: [\n {\n from: /^\\/libs\\/.*$/,\n to: function(context) {\n return '/bower_components' + context.parsedUrl.pathname;\n }\n }\n ]\n});\n```\n\nThe function will always be called with a context object that has the following properties:\n\n - **parsedUrl**: Information about the URL as provided by the [URL module's](https://nodejs.org/api/url.html#url_url_parse_urlstr_parsequerystring_slashesdenotehost) `url.parse`.\n - **match**: An Array of matched results as provided by `String.match(...)`.\n\n\n### verbose\nThis middleware does not log any information by default. If you wish to activate logging, then you can do so via the `verbose` option or by specifying a logger function.\n\n```javascript\nhistoryApiFallback({\n verbose: true\n});\n```\n\nAlternatively use your own logger\n\n```javascript\nhistoryApiFallback({\n logger: console.log.bind(console)\n});\n```\n","_attachments":{},"homepage":"https://github.com/dalhorinek/koa-history-api-fallback#readme","bugs":{"url":"https://github.com/dalhorinek/koa-history-api-fallback/issues"},"license":"MIT"}