UNPKG

blackbird-server

Version:
534 lines (533 loc) 15.5 kB
<!doctype html> <html lang="en"> <head> <title>Code coverage report for modules/middleware/stack.js</title> <meta charset="utf-8" /> <link rel="stylesheet" href="../../prettify.css" /> <link rel="stylesheet" href="../../base.css" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <style type='text/css'> .coverage-summary .sorter { background-image: url(../../sort-arrow-sprite.png); } </style> </head> <body> <div class='wrapper'> <div class='pad1'> <h1> <a href="../../index.html">all files</a> / <a href="index.html">modules/middleware/</a> stack.js </h1> <div class='clearfix'> <div class='fl pad1y space-right2'> <span class="strong">95.83% </span> <span class="quiet">Statements</span> <span class='fraction'>46/48</span> </div> <div class='fl pad1y space-right2'> <span class="strong">80% </span> <span class="quiet">Branches</span> <span class='fraction'>8/10</span> </div> <div class='fl pad1y space-right2'> <span class="strong">100% </span> <span class="quiet">Functions</span> <span class='fraction'>12/12</span> </div> <div class='fl pad1y space-right2'> <span class="strong">95.83% </span> <span class="quiet">Lines</span> <span class='fraction'>46/48</span> </div> </div> </div> <div class='status-line high'></div> <pre><table class="coverage"> <tr><td class="line-count quiet">1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157</td><td class="line-coverage quiet"><span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-no">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-no">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes">11×</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-neutral">&nbsp;</span> <span class="cline-any cline-yes"></span> <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">const d = require("describe-property"); const RoutingProperties = require("../utils/RoutingProperties"); const createMapper = require("./mapper"); const createRouter = require("./router"); &nbsp; function mapperCreator(mappings) { return function (app) { app = createMapper(app); &nbsp; for (let i = 0, len = mappings.length; i &lt; len; ++i) { app.map.apply(app, mappings[i]); } &nbsp; return app; }; } &nbsp; function routerCreator(routes) { return function (app) { app = createRouter(app); &nbsp; for (let i = 0, len = routes.length; i &lt; len; ++i) { app.route.apply(app, routes[i]); } &nbsp; return app; }; } &nbsp; /** * A middleware that aids in building complex apps that are fronted by other * middleware in a "middleware stack". Also provides several other useful methods * for request mapping and routing that make this middleware a good choice when * working with mach at a high level or when getting started for the first time. * * Middleware are placed into the stack by calling the `use` method which passes * along any additional arguments that it receives directly on to the middleware * when the stack is compiled. * * Other stacks can be "mounted" easily at various locations using the `map` * method. Routes can be added using `route`, `get`, `post`, etc. When a request * is received, all middleware, mappings, and routes run in the order they are * defined in the stack, top to bottom. * * let app = mach.stack(); * * app.use(mach.gzip); * app.use(mach.file, __dirname + '/public'); * * // Use an image server to serve requests that begin * // with /images out of /public/img. * app.map('/images', mach.file('/public/img')); * * // Since this call is *after* the call to map, this middleware * // will not run when requests begin with "/images". * app.use(mach.params); * * app.get('/', function (request) { * return "The params are: " + JSON.stringify(request.params); * }); * * app.post('/posts/:post_id/messages', function (request) { * // ... * }); * * mach.serve(app); * * Note: A stack is compiled the first time it is called. When a stack is * compiled, all middleware is invoked with the downstream app plus any * additional arguments that were passed to the call to stack.use. As long as * the stack doesn't change between requests, this happens only once. */ function createStack(app) { let layers = [], mappings = [], routes = []; let compiledApp; &nbsp; function compile(app) { <span class="missing-if-branch" title="if path not taken" >I</span>if (routes.length) { <span class="cstat-no" title="statement not covered" > app = routerCreator(routes)(app);</span> } &nbsp; <span class="missing-if-branch" title="if path not taken" >I</span>if (mappings.length) { <span class="cstat-no" title="statement not covered" > app = mapperCreator(mappings)(app);</span> } &nbsp; let index = layers.length; &nbsp; while (index) { app = layers[--index].call(this, app); } &nbsp; return app; } &nbsp; function stack(conn) { return conn.call(compiledApp || (compiledApp = compile(app))); } &nbsp; Object.defineProperties(stack, { &nbsp; /** * Declares that the given `middleware` should be used at the current point * in the stack. Any additional arguments to this function are passed along * to the middleware with the downstream app as the first argument when the * stack is compiled. */ use: d(function (middleware) { const args = Array.prototype.slice.call(arguments, 1); &nbsp; if (mappings.length) { layers.push(mapperCreator(mappings.splice(0, mappings.length))); } &nbsp; if (routes.length) { layers.push(routerCreator(routes.splice(0, routes.length))); } &nbsp; layers.push(function (app) { return middleware.apply(this, [app].concat(args)); }); &nbsp; compiledApp = null; }), &nbsp; /** * Uses a mapper to map a URL path to an app. */ map: d(function (location, app) { mappings.push([location, app]); compiledApp = null; }), &nbsp; /** * Uses a router to route URLs that match a pattern/method to an app. */ route: d(function (pattern, methods, app) { routes.push([pattern, methods, app]); compiledApp = null; }), &nbsp; /** * Sets the given app as the default for this stack. */ run: d(function (downstreamApp) { app = downstreamApp; compiledApp = null; }) &nbsp; }); &nbsp; Object.defineProperties(stack, RoutingProperties); &nbsp; return stack; } &nbsp; module.exports = createStack; &nbsp;</pre></td></tr> </table></pre> <div class='push'></div><!-- for sticky footer --> </div><!-- /wrapper --> <div class='footer quiet pad2 space-top1 center small'> Code coverage generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Wed Jul 06 2016 20:37:18 GMT-0500 (CDT) </div> </div> <script src="../../prettify.js"></script> <script> window.onload = function () { if (typeof prettyPrint === 'function') { prettyPrint(); } }; </script> <script src="../../sorter.js"></script> </body> </html>