connect-form

<html> <head> <title>Connect</title> <script src="http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js"></script> <style>body { margin: 0; padding: 0; font: 14px/1.5 'Palatino Linotype', 'Book Antiqua', Palatino, FreeSerif, serif; color: #252519; } a { color: #252519; } a:hover { text-decoration: underline; color: #19469D; } p { margin: 12px 0; } h1, h2, h3 { margin: 0; padding: 0; } table#source { width: 100%; border-collapse: collapse; } table#source td:first-child { padding: 30px 40px 30px 40px; vertical-align: top; } table#source td:first-child, table#source td:first-child pre { width: 450px; } table#source td:last-child { padding: 30px 0 30px 40px; border-left: 1px solid #E5E5EE; background: #F5F5FF; } table#source tr { border-bottom: 1px solid #E5E5EE; } table#source tr.filename { padding-top: 40px; border-top: 1px solid #E5E5EE; } table#source tr.filename td:first-child { text-transform: capitalize; } table#source tr.filename td:last-child { font-size: 12px; } table#source tr.filename h2 { margin: 0; padding: 0; cursor: pointer; } table#source tr.code h1, table#source tr.code h2, table#source tr.code h3 { margin-top: 30px; font-family: "Lucida Grande", "Helvetica Nueue", Arial, sans-serif; font-size: 18px; } table#source tr.code h2 { font-size: 16px; } table#source tr.code h3 { font-size: 14px; } table#source tr.code ul { margin: 15px 0 15px 35px; padding: 0; } table#source tr.code ul li { margin: 0; padding: 1px 0; } table#source tr.code ul li p { margin: 0; padding: 0; } table#source tr.code td:first-child pre { padding: 20px; } #ribbon { position: fixed; top: 0; right: 0; } code .string { color: #219161; } code .regexp { color: #219161; } code .keyword { color: #954121; } code .number { color: #19469D; } code .comment { color: #bbb; } code .this { color: #19469D; }</style> <script> $(function(){ $('tr.code').hide(); $('tr.filename').toggle(function(){ $(this).nextUntil('.filename').fadeIn(); }, function(){ $(this).nextUntil('.filename').fadeOut(); }); }); </script> </head> <body> <table id="source"><tbody><tr><td><h1>Connect</h1>High performance middleware for <a href="http://nodejs.org">node</a>.</td><td></td></tr><tr class="filename"><td><h2 id="lib/connect/middleware/bodyDecoder.js"><a href="#">bodyDecoder</a></h2></td><td>lib/connect/middleware/bodyDecoder.js</td></tr><tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var queryString = require('querystring');</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Supported decoders. <ul><li>application/x-www-form-urlencoded</li><li>application/json</li></ul> </td> <td class="code"> <pre><code>exports.decode = { 'application/x-www-form-urlencoded': queryString.parse, 'application/json': JSON.parse };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Decode request bodies. <h2></h2> <ul><li>return: Function </li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function bodyDecoder(){ return function bodyDecoder(req, res, next) { var decoder = exports.decode[mime(req)]; if (decoder) { var data = ''; req.setEncoding('utf8'); req.addListener('data', function(chunk) { data += chunk; }); req.addListener('end', function() { req.rawBody = data; try { req.body = data ? decoder(data) : {}; } catch (err) { return next(err); } next(); }); } else { next(); } } };</code></pre> </td> </tr><tr class="filename"><td><h2 id="lib/connect/middleware/cache.js"><a href="#">cache</a></h2></td><td>lib/connect/middleware/cache.js</td></tr><tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var Buffer = require('buffer').Buffer;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Cache in memory for the given <code>cacheDuration</code>. <h2></h2> <ul><li>param: Number cacheDuration</li><li>return: Function </li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function cache(cacheDuration){ var cache = {}, queue = {}; return function cache(req, res, next) { // Skip all requests that are not GET method if (req.method !== &quot;GET&quot;) { next(); return; } var key = req.headers[&quot;accept-encoding&quot;] + req.url, writeHead = res.writeHead, write = res.write, end = res.end, code, headers, chunks = [], totalSize = 0; function serve() { var resp = cache[key]; var headers = resp.headers; headers[&quot;Date&quot;] = (new Date).toUTCString(); headers[&quot;Content-Length&quot;] = resp.body.length; if (localQueue) { // Send everyone in the wait queue the response. for (var i = 0, l = localQueue.length; i &lt; l; i++) { var localRes = localQueue[i]; localRes.writeHead(resp.code, headers); localRes.end(resp.body); } // Kill the wait queue delete queue[key]; } else { res.writeHead(resp.code, headers); res.end(resp.body); } } // If there is a cache-hit, serve it right away! if (cache[key]) { serve(); return; } var localQueue = queue[key]; if (localQueue) { localQueue[localQueue.length] = res; return; } localQueue = queue[key] = [res]; // Defer the call to writeHead res.writeHead = function (setCode, setHeaders) { code = setCode; headers = setHeaders; }; // Buffer the response body as an array of Buffer objects res.write = function (chunk, encoding) { if (typeof chunk === 'string') { var length; if (!encoding || encoding === 'utf8') { length = Buffer.byteLength(chunk); } var buffer = new Buffer(length); buffer.write(chunk, encoding); chunks.push(buffer); } else { chunks.push(chunk); } totalSize += chunk.length; }; res.end = function (chunk, encoding) { if (chunk) { res.write(chunk, encoding); } // Combine the buffer array into a single buffer var body = new Buffer(totalSize); var offset = 0; chunks.forEach(function (chunk) { chunk.copy(body, offset); offset += chunk.length; }); // Store the result in the cache cache[key] = { body: body, code: code, headers: headers }; // Put the original methods back in place res.writeHead = writeHead; res.write = write; res.end = end; // Serve the response from the cache serve(); if (cacheDuration) { // Expire the ram cache after 100ms or the specified length setTimeout(function(){ delete cache[key]; }, cacheDuration); } else { // When the timeout is zero, just kill it right away delete cache[key]; } }; next(); }; };</code></pre> </td> </tr><tr class="filename"><td><h2 id="lib/connect/middleware/cacheManifest.js"><a href="#">cacheManifest</a></h2></td><td>lib/connect/middleware/cacheManifest.js</td></tr><tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var fs = require('fs'), Utils = require('../utils'), Url = require('url'), Path = require('path');</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Generate cache manifest for the given <code>root</code>, <code>networks</code>, and <code>fallbacks</code>. <h2></h2> <ul><li>param: String root</li><li>param: Array networks</li><li>param: Array fallbacks</li><li>return: Function </li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function cacheManifest(root, networks, fallbacks) { root = root || process.cwd(); var suffix = &quot;&quot;; // List of networks as an array of strings if (networks) { suffix += &quot;\n\nNETWORK:\n&quot; + networks.join(&quot;\n&quot;); } // List of fallbacks as key/value pairs if (fallbacks) { suffix += &quot;\n\nFALLBACK:\n&quot; + fallbacks.map(function (second, first) { return first + &quot; &quot; + second; }).join(&quot;\n&quot;); } return function cacheManifest(req, res, next) { if (Url.parse(req.url).pathname === &quot;/cache.manifest&quot;) { Utils.find(root, (/./), function (err, files) { var latestMtime = 0; files = files.map(function (entry) { if (entry.mtime &gt; latestMtime) { latestMtime = entry.mtime; } return entry.path.substr(1); }); var manifest = &quot;CACHE MANIFEST\n&quot; + &quot;# &quot; + latestMtime.toUTCString() + &quot;\n&quot; + files.join(&quot;\n&quot;) + suffix; res.writeHead(200, { &quot;Content-Type&quot;: &quot;text/cache-manifest&quot;, &quot;Last-Modified&quot;: latestMtime.toUTCString(), &quot;Content-Length&quot;: manifest.length }); res.end(manifest); }); return; } next(); }; };</code></pre> </td> </tr><tr class="filename"><td><h2 id="lib/connect/middleware/compiler.js"><a href="#">compiler</a></h2></td><td>lib/connect/middleware/compiler.js</td></tr><tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var fs = require('fs'), path = require('path');</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Bundled compilers: <ul><li><a href="http://github.com/visionmedia/sass.js">sass</a> to css</li><li><a href="http://github.com/cloudhead/less.js">less</a> to css</li></ul> </td> <td class="code"> <pre><code>var compilers = exports.compilers = { sass: { match: /\.css$/, ext: '.sass', compile: function(str, fn){ require.async('sass', function(err, sass){ if (err) { fn(err); } else { try { fn(null, sass.render(str)); } catch (err) { fn(err); } } }); } }, less: { match: /\.css$/, ext: '.less', compile: function(str, fn){ require.async('less', function(err, less){ if (err) { fn(err); } else { try { less.render(str, fn); } catch (err) { fn(err); } } }); } } };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Setup compiler. <h2>Options</h2> <ul><li><code>src</code> Source directory, defaults to CWD.</li><li><code>dest</code> Destination directory, defaults <code>src</code>.</li><li><code>enable</code> Array of enabled compilers.</li></ul> <h2>Compilers</h2> <ul><li><code>sass</code> Compiles cass to css</li><li><code>less</code> Compiles less to css</li></ul> <h2></h2> <ul><li>param: Object options</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function compiler(options){ options = options || {}; var srcDir = process.connectEnv.compilerSrc || options.src || process.cwd(), destDir = process.connectEnv.compilerDest || options.dest || srcDir, enable = options.enable; if (!enable || enable.length === 0) { throw new Error(s &quot;enable&quot; option is not set, nothing will be compiled.'); } return function compiler(req, res, next){ for (var i = 0, len = enable.length; i &lt; len; ++i) { var name = enable[i], compiler = compilers[name]; if (compiler.match.test(req.url)) { var src = (srcDir + req.url).replace(compiler.match, compiler.ext), dest = destDir + req.url; // Compare mtimes fs.stat(src, function(err, srcStats){ if (err) { if (err.errno === process.ENOENT) { res.writeHead(404, { 'Content-Type': 'text/plain' }); res.end('Not Found'); } else { next(err); } } else { fs.stat(dest, function(err, destStats){ if (err) { // Oh snap! it does not exist, compile it if (err.errno === process.ENOENT) { compile(); } else { next(err); } } else { // Source has changed, compile it if (srcStats.mtime &gt; destStats.mtime) { compile(); } else { // Defer file serving next(); } } }) } }); // Compile to the destination function compile() { fs.readFile(src, 'utf8', function(err, str){ if (err) { next(err); } else { compiler.compile(str, function(err, str){ if (err) { next(err); } else { fs.writeFile(dest, str, 'utf8', function(err){ next(err); }); } }); } }); } return; } } next(); }; };</code></pre> </td> </tr><tr class="filename"><td><h2 id="lib/connect/middleware/conditionalGet.js"><a href="#">conditionalGet</a></h2></td><td>lib/connect/middleware/conditionalGet.js</td></tr><tr class="code"> <td class="docs"> Conditional GET request support. <h2></h2> <ul><li>return: Function </li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function conditionalGet(){ return function conditionalGet(req, res, next) { // Skip all requests that are not conditional gets. if (!(req.method === &quot;GET&quot; &amp;&amp; (req.headers[&quot;if-modified-since&quot;] || req.headers[&quot;if-none-match&quot;]) )) { next(); return; } var since = req.headers[&quot;if-modified-since&quot;], oldEtag = req.headers[&quot;if-none-match&quot;], writeHead = res.writeHead, write = res.write, end = res.end; since = since &amp;&amp; Date.parse(since).valueOf(); res.writeHead = function (code, headers) { var lastModified = headers[&quot;Last-Modified&quot;], etag = headers[&quot;Etag&quot;]; lastModified = lastModified &amp;&amp; Date.parse(lastModified).valueOf(); // If there is no match, then move on. if (!(code === 200 &amp;&amp; (lastModified === since || oldEtag === etag) )) { res.writeHead = writeHead; res.writeHead(code, headers); return; } // Ignore writes res.write = function () {}; res.end = function () { // Put the original functions back on. res.writeHead = writeHead; res.write = write; res.end = end; // Filter out any Content based headers since there is no // content. var newHeaders = {}; headers.forEach(function (value, key) { if (key.indexOf(&quot;Content&quot;) &lt; 0) { newHeaders[key] = value; } }); res.writeHead(304, newHeaders); res.end(); }; }; next(); }; };</code></pre> </td> </tr><tr class="filename"><td><h2 id="lib/connect/middleware/cookieDecoder.js"><a href="#">cookieDecoder</a></h2></td><td>lib/connect/middleware/cookieDecoder.js</td></tr><tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var utils = require('./../utils');</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Parse Cookie header and populate <code>req.cookies</code>. <h2></h2> <ul><li>return: Function </li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function cookieDecoder(){ return function cookieDecoder(req, res, next) { var cookie = req.headers.cookie; req.cookies = {}; if (cookie) { try { req.cookies = utils.parseCookie(cookie); delete req.headers.cookie; } catch (err) { // Ignore } next(); } else { next(); } }; };</code></pre> </td> </tr><tr class="filename"><td><h2 id="lib/connect/middleware/errorHandler.js"><a href="#">errorHandler</a></h2></td><td>lib/connect/middleware/errorHandler.js</td></tr><tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var utils = require('./../utils'), sys = require('sys'), fs = require('fs');</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Setup error handler with the given <code>options</code>. <h2>Options</h2> <ul><li><code>showStack</code> respond with both the error message and stack trace. Defaults to <code>false</code></li><li><code>showMessage</code> respond with the exception message only. Defaults to <code>false</code></li><li><code>dumpExceptions</code> dump exceptions to stderr (without terminating the process). Defaults to <code>false</code></li></ul> <h2></h2> <ul><li>param: Object options</li><li>return: Function </li><li>api: public</li></ul> </td> <td class="code"> <pre><code>module.exports = function errorHandler(options){ options = options || {}; // Defaults var showStack = options.showStack, showMessage = options.showMessage, dumpExceptions = options.dumpExceptions; // --showErrorStack if (process.connectEnv.showErrorStack !== undefined) { showStack = op = utils.toBoolean(process.connectEnv.showErrorStack); } // --showErrorMessage if (process.connectEnv.showErrorMessage !== undefined) { showMessage = <span class=