node-http-server

Version:

A very simple and fast http server for node, bash, and spawnable from C, Python etc. It is lightweight and great for embedded solutions as well as everyday development or public facing apps.

github.com/RIAEvangelist/node-http-server

RIAEvangelist/node-http-server

976 lines (893 loc) • 50.9 kB

HTML

<!DOCTYPE html> <html> <head> <title>Node http server with https and proxy support</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <meta name="viewport" content="width=device-width, target-densitydpi=160dpi, initial-scale=1.0; maximum-scale=1.0; user-scalable=0;"> <link rel="stylesheet" media="all" href="assets/file_1.css"/> <link rel="stylesheet" media="all" href="assets/file_5.css"/> <link rel="stylesheet" media="all" href="assets/32px.png"/> <link rel="stylesheet" media="all" href="assets/40px.png"/> <link rel="stylesheet" media="all" href="assets/throbber.gif"/> <link rel="stylesheet" media="all" href="assets/file_7.css"/> <link rel="stylesheet" media="all" href="assets/file_8.css"/> <script src="assets/file_2.js" type="text/javascript"></script> <script src="assets/file_3.js" type="text/javascript"></script> <script src="assets/file_4.js" type="text/javascript"></script> <script src="assets/file_6.js" type="text/javascript"></script> <script type="application/json" id="jsTreeJSON"> [{"id":"./example/basic/https-advancedApp.js","text":"https-advancedApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/https-advancedApp.js.html"},"state":{"selected":false}},{"id":".","text":".","icon":"jstree-folder","parent":"#","a_attr":{"href":"."},"state":{"opened":true}},{"id":"./example","text":"example","icon":"jstree-folder","parent":".","a_attr":{"href":"example"},"state":{"opened":false}},{"id":"./example/readme.md","text":"readme.md","icon":"jstree-file","parent":"./example","a_attr":{"href":"example/readme.md.html"},"state":{"selected":false}},{"id":"./example/advanced","text":"advanced","icon":"jstree-folder","parent":"./example","a_attr":{"href":"example/advanced"},"state":{"opened":false}},{"id":"./example/advanced/basicTemplate.js","text":"basicTemplate.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/basicTemplate.js.html"},"state":{"selected":false}},{"id":"./example/advanced/https-ONLY-basicTemplate.js","text":"https-ONLY-basicTemplate.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/https-ONLY-basicTemplate.js.html"},"state":{"selected":false}},{"id":"./example/advanced/https-basicTemplate.js","text":"https-basicTemplate.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/https-basicTemplate.js.html"},"state":{"selected":false}},{"id":"./example/advanced/https-randomCSS.js","text":"https-randomCSS.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/https-randomCSS.js.html"},"state":{"selected":false}},{"id":"./example/advanced/https-requestBenchmark.js","text":"https-requestBenchmark.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/https-requestBenchmark.js.html"},"state":{"selected":false}},{"id":"./example/advanced/randomCSS.js","text":"randomCSS.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/randomCSS.js.html"},"state":{"selected":false}},{"id":"./example/advanced/requestBenchmark.js","text":"requestBenchmark.js","icon":"jstree-file","parent":"./example/advanced","a_attr":{"href":"example/advanced/requestBenchmark.js.html"},"state":{"selected":false}},{"id":"./example/basic","text":"basic","icon":"jstree-folder","parent":"./example","a_attr":{"href":"example/basic"},"state":{"opened":false}},{"id":"./example/basic/advancedApp.js","text":"advancedApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/advancedApp.js.html"},"state":{"selected":false}},{"id":"./example/basic/basicApp.js","text":"basicApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/basicApp.js.html"},"state":{"selected":false}},{"id":"./example/basic/basicLogging.js","text":"basicLogging.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/basicLogging.js.html"},"state":{"selected":false}},{"id":"./example/basic/cluster-basicApp.js","text":"cluster-basicApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/cluster-basicApp.js.html"},"state":{"selected":false}},{"id":"./example/basic/https-ONLY-basicApp.js","text":"https-ONLY-basicApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/https-ONLY-basicApp.js.html"},"state":{"selected":false}},{"id":"./README.md","text":"README.md","icon":"jstree-file","parent":".","a_attr":{"href":"README.md.html"},"state":{"selected":true}},{"id":"./example/basic/https-basicApp.js","text":"https-basicApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/https-basicApp.js.html"},"state":{"selected":false}},{"id":"./example/basic/https-basicLogging.js","text":"https-basicLogging.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/https-basicLogging.js.html"},"state":{"selected":false}},{"id":"./example/basic/https-multipleDomains.js","text":"https-multipleDomains.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/https-multipleDomains.js.html"},"state":{"selected":false}},{"id":"./example/basic/https-verboseApp.js","text":"https-verboseApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/https-verboseApp.js.html"},"state":{"selected":false}},{"id":"./example/basic/multipleDomains.js","text":"multipleDomains.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/multipleDomains.js.html"},"state":{"selected":false}},{"id":"./example/basic/verboseApp.js","text":"verboseApp.js","icon":"jstree-file","parent":"./example/basic","a_attr":{"href":"example/basic/verboseApp.js.html"},"state":{"selected":false}},{"id":"./example/proxy","text":"proxy","icon":"jstree-folder","parent":"./example","a_attr":{"href":"example/proxy"},"state":{"opened":false}},{"id":"./example/proxy/basic.js","text":"basic.js","icon":"jstree-file","parent":"./example/proxy","a_attr":{"href":"example/proxy/basic.js.html"},"state":{"selected":false}},{"id":"./example/proxy/https-and-http-basic.js","text":"https-and-http-basic.js","icon":"jstree-file","parent":"./example/proxy","a_attr":{"href":"example/proxy/https-and-http-basic.js.html"},"state":{"selected":false}},{"id":"./example/proxy/https-and-http-google-proxy.js","text":"https-and-http-google-proxy.js","icon":"jstree-file","parent":"./example/proxy","a_attr":{"href":"example/proxy/https-and-http-google-proxy.js.html"},"state":{"selected":false}},{"id":"./server","text":"server","icon":"jstree-folder","parent":".","a_attr":{"href":"server"},"state":{"opened":false}},{"id":"./server/Config.js","text":"Config.js","icon":"jstree-file","parent":"./server","a_attr":{"href":"server/Config.js.html"},"state":{"selected":false}},{"id":"./server/Server.js","text":"Server.js","icon":"jstree-file","parent":"./server","a_attr":{"href":"server/Server.js.html"},"state":{"selected":false}},{"id":"./bin","text":"bin","icon":"jstree-folder","parent":".","a_attr":{"href":"bin"},"state":{"opened":false}},{"id":"./bin/nhs.js","text":"nhs.js","icon":"jstree-file","parent":"./bin","a_attr":{"href":"bin/nhs.js.html"},"state":{"selected":false}},{"id":"./local-certs","text":"local-certs","icon":"jstree-folder","parent":".","a_attr":{"href":"local-certs"},"state":{"opened":false}},{"id":"./local-certs/readme.md","text":"readme.md","icon":"jstree-file","parent":"./local-certs","a_attr":{"href":"local-certs/readme.md.html"},"state":{"selected":false}}] </script> </head> <body class="markdown-body"> <h1> Node http server with https and proxy support </h1> <div class="subHeading"> ./README.md </div> <button type="button" class="navigatorToggle">☰ files...</button> <nav class="navigationTree minimized"> <input type="text" id="jsTreeSearch" placeholder="search..."/> <div></div> </nav> <section> <ul class="sectionDetails docsOnly"> <li id="section-1"> <div class="annotation"> <hr> Simple to use stand alone node HTTP and HTTPS Server you can spin up in seconds. <ul> <li><a href="#examples">TLDR; Quick start examples</a></li> <li><a href="#server-class">Server Class</a></li> <li><a href="#config-class">Config Class</a></li> <li><a href="#basic-cluster-server">Basic use with cluster example</a></li> </ul> Support for building proxy servers has been added. Documentation coming in next release. <a href="https://github.com/RIAEvangelist/node-http-server/tree/master/example/proxy">For now see the node-http-server proxy examples</a>. <code>npm i node-http-server</code> npm info : <a href="http://npm-stat.com/charts.html?package=node-http-server&author=&from=&to=">See npm trends and stats for node-http-server</a> <img src="https://img.shields.io/npm/v/node-http-server.svg" alt="node-http-server npm version"> <img src="https://img.shields.io/node/v/node-http-server.svg" alt="supported node version for node-http-server"> <img src="https://img.shields.io/npm/dt/node-http-server.svg" alt="total npm downloads for node-http-server"> <img src="https://img.shields.io/npm/dm/node-http-server.svg" alt="monthly npm downloads for node-http-server"> <img src="https://img.shields.io/npm/l/node-http-server.svg" alt="npm licence for node-http-server"> GitHub info : <img src="https://img.shields.io/github/release/RIAEvangelist/node-http-server.svg" alt="node-http-server GitHub Release"> <img src="https://img.shields.io/github/license/RIAEvangelist/node-http-server.svg" alt="GitHub license node-http-server license"> <img src="https://img.shields.io/github/issues/RIAEvangelist/node-http-server.svg" alt="open issues for node-http-server on GitHub"> <a href="https://www.codacy.com/app/RIAEvangelist/node-http-server?utm_source=github.com&utm_medium=referral&utm_content=RIAEvangelist/node-http-server&utm_campaign=badger"><img src="https://api.codacy.com/project/badge/Grade/fbfd39a7b56643d290bb93db61b14db3" alt="Codacy Badge"></a> <a href="https://www.npmjs.com/package/node-http-server"><img src="https://nodei.co/npm/node-http-server.png?downloads=true&downloadRank=true&stars=true" alt="node-http-server stats"></a> Package Quality : <img src="http://npm.packagequality.com/badge/node-http-server.png" alt="node-http-server Package Quality"> <a href="http://riaevangelist.github.io/node-http-server/">See the code documentation on riaevangelist.github.io</a> <h2 id="cli-use-if-you-just-want-to-test">cli use if you just want to test</h2> Now you can also use the node-http-server cli if you just want to spin up a basic file server to test something out quickly or share on the local network. <pre><code class="lang-sh"> $ sudo npm i -g node-http-server //start a node-http-server from the current directory on the default port 8080 $ node-http-server </code></pre> You can modify any of the config keys by passing their key value pairs as args. <pre><code class="lang-sh"> //start a verbose node-http-server from the current directory on port 1942 $ node-http-server port=1942 verbose=true </code></pre> <h3 id="quick-npm-script-tests-and-examples">quick npm script tests and examples</h3> <pre><code class="lang-sh"> #node ./example/basic/basicApp.js npm run basic #node ./example/basic/https-ONLY-basicApp.js npm run https #node ./example/basic/https-basicApp.js npm run both #node ./example/advanced/basicTemplate.js npm run template #node ./example/basic/cluster-basicApp.js npm run cluster </code></pre> <h2 id="writing-a-node-http-or-https-server">writing a node http or https server</h2> The below table shows all of the methods available on the server when you require this module. <pre><code class="lang-javascript"> const server=require('node-http-server'); server.deploy(); </code></pre> If you want to create a custom Server or extend the Server Class you can require just the server class. <pre><code class="lang-javascript"> const Server=require('node-http-server').Server; class MyCustomServer extends Server{ constructor(){ super(); } } const server=new MyCustomServer; server.deploy(); </code></pre> <h2 id="server-class">Server Class</h2> <table> <thead> <tr> <th>Server Method or member</th> <th>params</th> <th>returns / should return</th> <th>description</th> </tr> </thead> <tbody> <tr> <td><a href="#deploy">deploy</a></td> <td><code>userConfig</code> obj (optional), <code>readyCallback</code> fn (optional)</td> <td>returns void</td> <td>Starts the server. if a config object is passed it will shallow merge it with a clean instantion of the Config class.</td> </tr> <tr> <td><a href="#onrawrequest">onRawRequest</a></td> <td><code>request</code> obj, <code>response</code> obj, <code>serve</code> fn</td> <td>should return true,false or void</td> <td>Called immediately upon reciept of http(s) request. Called before any request parsing, useful for <code>proxy servers</code> and request modification, high speed handling, or rejection. Mildly more complex to work with because the request object has not been parsed and decorated with helper members. If this function returns true, the servers response lifecycle will be exited and you must manually call serve. this allows manual immediate and manual async serving. use the <code>serve</code> argument, <code>server.serve</code> or <code>server.serveFile</code> to manually serve the response.</td> </tr> <tr> <td><a href="#onrequest">onRequest</a></td> <td><code>request</code> obj, <code>response</code> obj, <code>serve</code> fn</td> <td>should return true,false or void</td> <td>Called when request received. If this function returns true, the servers response lifecycle will be exited and you must manually call serve. this allows manual immediate and manual async serving. use the <code>serve</code> argument, <code>server.serve</code> or <code>server.serveFile</code> to manually serve the response.</td> </tr> <tr> <td><a href="#beforeserve">beforeServe</a></td> <td><code>request</code> obj, <code>response</code> obj, <code>body</code> obj, <code>encoding</code> obj, <code>serve</code> fn</td> <td>should return true,false or void</td> <td>Called just before data is served to the client. If this function returns true, the servers response lifecycle will be exited and you must manually call serve. this allows manual immediate and manual async serving. use the <code>serve</code> argument, <code>server.serve</code> or <code>server.serveFile</code> to manually serve the response.</td> </tr> <tr> <td><a href="#afterserve">afterServe</a></td> <td><code>request</code> obj</td> <td>void</td> <td>Called once data has been fully sent to client.</td> </tr> <tr> <td><a href="#config-class">Config</a></td> <td>n/a</td> <td>n/a</td> <td>This is a reference to the Default Config class. Use it to generate a complete config file based off of the default values and arguments passed in when launching the app. Will perform a shallow merge of default values and passed values if a config object passed.</td> </tr> <tr> <td><a href="#server-class">Server</a></td> <td>n/a</td> <td>n/a</td> <td>This is a reference to the Server Class. Use it to start multiple servers on different ports or to extend the node-http-server.</td> </tr> </tbody> </table> <h2 id="request-uri-query-and-body">request uri, query, and, body</h2> For handling api requests, posts, puts patches etc with body data, we are now making that available on the request as both a <code>String</code> and <code>Buffer</code> incase you need images or videos uploaded. <table> <thead> <tr> <th>key</th> <th>type</th> <th>value</th> </tr> </thead> <tbody> <tr> <td>request.body</td> <td>string</td> <td>request body</td> </tr> <tr> <td>request.url</td> <td>string</td> <td>processed uri</td> </tr> <tr> <td>request.uri</td> <td>object</td> <td>parsed url information and query</td> </tr> <tr> <td>request.serverRoot</td> <td>string</td> <td>local dir for publicly served data</td> </tr> </tbody> </table> <table> <thead> <tr> <th>key</th> <th>type</th> <th>value</th> </tr> </thead> <tbody> <tr> <td>uri.protocol</td> <td>string</td> <td>protocol of request</td> </tr> <tr> <td>uri.host</td> <td>string</td> <td>hostname for domain</td> </tr> </tbody> </table> uri.hostname |string| hostname for domain| |uri.query |object| parsed querystring| |uri.port |number| port request was received on| <h3 id="-server-methods-http-riaevangelist-github-io-node-http-server-server-server-js-html-"><a href="http://riaevangelist.github.io/node-http-server/server/Server.js.html">Server Methods</a></h3> <h4 id="deploy">deploy</h4> <code>server.deploy</code> starts the server. <code>server.deploy(userConfig,readyCallback)</code> <table> <thead> <tr> <th>method</th> <th>returns</th> </tr> </thead> <tbody> <tr> <td>deploy</td> <td>void</td> </tr> </tbody> </table> <table> <thead> <tr> <th>parameter</th> <th>required</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>userConfig</td> <td>no</td> <td>if a <code>userConfig</code> object is passed it will decorate the <a href="http://riaevangelist.github.io/node-http-server/server/Config.js.html">Config class</a></td> </tr> <tr> <td>readyCallback</td> <td>no</td> <td>called once the server is started</td> </tr> </tbody> </table> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.deploy( { port:8000, root:'~/myApp/' }, serverReady ); server.deploy( { port:8888, root:'~/myOtherApp/' }, serverReady ); function serverReady(server){ console.log( `Server on port ${server.config.port} is now up`); } </code></pre> <h4 id="onrawrequest">onRawRequest</h4> <code>server.onRawRequest</code> <code>server.onRawRequest(request,response,serve)</code> <table> <thead> <tr> <th>method</th> <th>should return</th> </tr> </thead> <tbody> <tr> <td>onRawRequest</td> <td>bool/void</td> </tr> </tbody> </table> <table> <thead> <tr> <th>parameter</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>request</td> <td>http(s) request obj</td> </tr> <tr> <td>response</td> <td>http(s) response obj</td> </tr> <tr> <td>serve</td> <td>ref to <code>server.serve</code></td> </tr> </tbody> </table> <pre><code class="lang-javascript"> const server=require('node-http-server'); const config=new server.Config; config.port=8000; server.onRawRequest=gotRequest; server.deploy(config); function gotRequest(request,response,serve){ console.log(request.uri,request.headers); serve( request, response, JSON.stringify( { uri:request.uri, headers:request.headers } ) ); return true; } </code></pre> <h4 id="onrequest">onRequest</h4> <code>server.onRequest</code> <code>server.onRequest(request,response,serve)</code> <table> <thead> <tr> <th>method</th> <th>should return</th> </tr> </thead> <tbody> <tr> <td>onRequest</td> <td>bool/void</td> </tr> </tbody> </table> <table> <thead> <tr> <th>parameter</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>request</td> <td>http(s) request obj</td> </tr> <tr> <td>response</td> <td>http(s) response obj</td> </tr> <tr> <td>serve</td> <td>ref to <code>server.serve</code></td> </tr> </tbody> </table> <pre><code class="lang-javascript"> const server=require('node-http-server'); const config=new server.Config; config.port=8099; config.verbose=true; server.onRequest=gotRequest; server.deploy(config); function gotRequest(request,response,serve){ //at this point the request is decorated with helper members lets take a look at the query params if there are any. console.log(request.query,request.uri,request.headers); //lets only let the requests with a query param of hello go through if(request.query.hello){ // remember returning false means do not inturrupt the response lifecycle // and that you will not be manually serving return false; } serve( request, response, JSON.stringify( { success:false, message:'you must have a query param of hello to access the server i.e. /index.html?hello' uri:request.uri, query:request.query } ) ); //now we let the server know we want it to kill the normal request lifecycle //because we just completed it by serving above. we could also handle it async style //and request a meme or something from the web and put that on the page (or something...) return true; } </code></pre> <h4 id="beforeserve">beforeServe</h4> <code>server.beforeServe</code> <code>server.beforeServe(request,response,body,encoding,serve)</code> <table> <thead> <tr> <th>method</th> <th>should return</th> </tr> </thead> <tbody> <tr> <td>beforeServe</td> <td>bool/void</td> </tr> </tbody> </table> <table> <thead> <tr> <th>parameter</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>request</td> <td>http(s) request obj</td> </tr> <tr> <td>response</td> <td>http(s) response obj</td> </tr> <tr> <td>body</td> <td>response content body RefString</td> </tr> <tr> <td>encoding</td> <td>response body encoding RefString</td> </tr> <tr> <td>serve</td> <td>ref to <code>server.serve</code></td> </tr> </tbody> </table> type <code>RefString</code> <table> <thead> <tr> <th>type</th> <th>keys</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>RefString</td> <td><code>value</code></td> <td>a way to allow modifying a string by refrence.</td> </tr> </tbody> </table> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.beforeServe=beforeServe; function beforeServe(request,response,body,encoding){ //only parsing html files for this example if(response.getHeader('Content-Type')!=server.config.contentType.html){ //return void||false to allow response lifecycle to continue as normal return; } const someVariable='this is some variable value'; body.value=body.value.replace('{{someVariable}}',someVariable); //return void||false to allow response lifecycle to continue as normal //with modified body content return; } server.deploy( { port:8000, root:`${__dirname}/appRoot/` } ); </code></pre> <h4 id="afterserve">afterServe</h4> <code>server.afterServe</code> <code>server.afterServe(request)</code> <table> <thead> <tr> <th>method</th> <th>should return</th> </tr> </thead> <tbody> <tr> <td>afterServe</td> <td>n/a</td> </tr> </tbody> </table> <table> <thead> <tr> <th>parameter</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>request</td> <td>decorated http(s) request obj</td> </tr> </tbody> </table> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.afterServe=afterServe; function afterServe(request){ console.log(`just served ${request.uri}`); } server.deploy( { port:8075, root:`${__dirname}/appRoot/` } ); </code></pre> <h2 id="examples">Examples</h2> To see the node http server in action run <code>npm start</code> from the root of this repo and then visit <a href="http://localhost:8000">localhost:8000</a>. To start only an https example server <code>npm run https</code> from the root of this repo and then visit <a href="http://localhost:4433">localhost:4433</a>. To spin up both an http and an https server <code>npm run both</code> from the root of this repo and then visit <a href="http://localhost:4433">localhost:4433</a> or <a href="http://localhost:8000">localhost:8000</a>. Detailed examples can be found in the <a href="https://github.com/RIAEvangelist/node-http-server/tree/master/example">example folder</a> or under the example folder on the <a href="http://riaevangelist.github.io/node-http-server/example/readme.md.html">node-http-server example docs</a> The basic example directory is static http and https file servers and the advanced directory has dynamic server side rendering http and https examples including a benchmark example. The <code>proxy</code> examples show manual serving and response modification examples. <h1 id="basic-http-server-example">Basic http server example</h1> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.deploy( { port:8000, root:'~/myApp/' } ); </code></pre> <h1 id="basic-https-only-server-example">Basic https only server example</h1> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.deploy( { port:8000, root:'~/myApp/', https:{ privateKey:`/path/to/your/certs/private/server.key`, certificate:`/path/to/your/certs/server.pub`, port:4433, only:true } } ); </code></pre> <h1 id="basic-server-running-both-http-and-https">Basic server running both http and https</h1> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.deploy( { port:8000, root:'~/myApp/', https:{ privateKey:`/path/to/your/certs/private/server.key`, certificate:`/path/to/your/certs/server.pub`, port:4433 } } ); </code></pre> <h2 id="basic-cluster-server">Basic cluster server</h2> <pre><code class="lang-javascript"> //import the `node-http-server` module //` const server=require(‘node-http-server’); ` const server=require('../../server/Server.js'); //import cluster const cluster = require('cluster'); const numCPUs = require('os').cpus().length; if (cluster.isMaster) { console.log(`Master ${process.pid} is running`); // Fork node-http-server cluster workers. for (let i = 0; i < numCPUs; i++) { cluster.fork(); } cluster.on( 'exit', (worker, code, signal) => { console.log(`worker ${worker.process.pid} died`); } ); } else { server.afterServe=(request)=>{ console.log(`${process.pid} served ${request.uri.path}`); } //start server in clustered children server.deploy( { verbose: false, port: 8000, root:__dirname+'/appRoot/' } ); console.log(`Worker ${process.pid} started listening on ${server.config.port}`); } </code></pre> <h2 id="template-filling">Template filling</h2> <pre><code class="lang-javascript"> const server=require('node-http-server'); server.beforeServe=beforeServe; function beforeServe(request,response,body,encoding){ //only parsing html files for this example if(response.getHeader('Content-Type')!=server.config.contentType.html){ return; } const someVariable='this is some variable value'; body.value=body.value.replace('{{someVariable}}',someVariable); } server.deploy( { port:8000, root:`${__dirname}/appRoot/` } ); </code></pre> <hr> <h2 id="custom-configuration">Custom configuration</h2> for http : <pre><code class="lang-javascript"> const server=require('node-http-server'); const config=new server.Config; config.errors['404'] = 'These are not the files you are looking for...'; config.contentType.mp4 = 'video/mp4'; config.port = 8005; config.verbose = true; config.root = '~/myApp/' server.deploy(config); </code></pre> for https : <pre><code class="lang-javascript"> const server=require('node-http-server'); const config=new server.Config; config.errors['404'] = 'These are not the files you are looking for...'; config.contentType.mp4 = 'video/mp4'; config.port = 8005; config.verbose = true; config.root = '~/myApp/' config.https.privateKey = `/path/to/your/certs/private/server.key`; config.https.certificate= `/path/to/your/certs/server.pub`; config.https.port = 4433; config.https.only = true; server.deploy(config); </code></pre> <hr> <h2 id="multiple-domains-or-subdomains">Multiple domains or subdomains</h2> <pre><code class="lang-javascript"> const server=require('node-http-server'); const config={ port:8010, root:__dirname + '/www/myApp/', domain:'myapp.com', domains:{ 'a.myapp.com':__dirname+'/www/a-myApp/', 'yourapp.com':__dirname+'/someFolder/yourApp/' } } server.deploy(config); </code></pre> <h2 id="-config-class-http-riaevangelist-github-io-node-http-server-server-config-js-html-"><a href="http://riaevangelist.github.io/node-http-server/server/Config.js.html">Config Class</a></h2> <h3 id="default-node-http-server-configuration">Default node HTTP server configuration</h3> All of these can be modified and passed into <code>new server.Server(myConfigs)</code> or <code>server.deploy(myConfigs)</code> <pre><code class="lang-javascript"> const myConfig=new server.Config; myConfig.verbose=true; myConfig.port=9922; const myServer=new server.Server(config); myServer.deploy(); //or more basically server.deploy({port:9922,verbose:true}); </code></pre> <h4 id="defaults-description">defaults description</h4> <pre><code class="lang-javascript"> { verbose : (args.verbose=='true')||false, port : args.port||defaults.port, root : args.root||defaults.root, domain : args.domain||defaults.domain, https :{ ca:'', privateKey:'', certificate:'', port:443, only:false }, log : false, logFunction : serverLogging, domains : { /*******************\ * domain : /that/domains/root/dir * * for sub domains, specify the whole host i.e. "my.sub.domain" * you may need to edit your hosts file, cnames or iptable * domain or my.domain etc. goes to 127.0.0.1 for local development * *****************/ }, server : { index : args.index||defaults.index, noCache : args.noCache=='false' ? false : true, timeout : 30000 //30 second timeout }, contentType : { html : 'text/html', css : 'text/css', js : 'text/javascript', json : 'application/json', txt : 'text/plain', jpeg : 'image/jpeg', jpg : 'image/jpeg', png : 'image/png', gif : 'image/gif', ico : 'image/x-icon', appcache: 'text/cache-manifest' }, restrictedType: { }, errors:{ headers : { 'Content-Type' : 'text/plain' }, 404: '404 MIA', 415: '415 File type not supported', 403: '403 Access Denied', 500: '500 {{err}}' } }; </code></pre> <table> <thead> <tr> <th>key</th> <th>description</th> </tr> </thead> <tbody> <tr> <td>verbose</td> <td>display detailed info about what server is doing via terminal.</td> </tr> <tr> <td>port</td> <td>the port on which the server should run</td> </tr> <tr> <td>root</td> <td>the absolute path to the root dir for the domain</td> </tr> <tr> <td>domain</td> <td>the server domain. To accept incoming requests for ANY Applicable Domain use <code>0.0.0.0</code> this will allow any request that is pointed at this machine on the specified port to use this server config.</td> </tr> <tr> <td>https</td> <td>settings for https, these wil only take effect if both a <code>privateKey</code> and a <code>certificate</code> are specified. Setting <code>only</code> to be true means the instance will only serve over https</td> </tr> <tr> <td>https.privateKey</td> <td>path to your servers private key like ./local-certs/private/server.key or similar</td> </tr> <tr> <td>https.certificate</td> <td>path to your servers public cert like ./local-certs/client.pub or similar</td> </tr> <tr> <td>https.ca</td> <td>path to your officially signed CA’s certificate authority file servers public cert like ./local-certs/ca-bundle.crt or similar. This is often needed for officially signed and generated certs, but not for self signed certs so it is optional.</td> </tr> <tr> <td>log</td> <td>full path to log file, if specified and the file is not present, it will be created, however the dir must be there. Example path : <code>/tmp/server.log</code> It is recommended that you timestamp this file name with a time stamp like : <code>'~/serverLogs/domain-'+new Date().getTime()+'.log'</code> this will create a new log file each time the server is started/restarted/reboot etc…</td> </tr> <tr> <td>logFunction</td> <td>the default function appends timestamps to the headers object and logs as JSON in the <code>log</code> file. You can assign your own function here as well. It should accepts a javascript Object as the first argument.</td> </tr> <tr> <td>domains.*</td> <td>this is a mapping of hostname to path. It can be used for multiple different domains, or for subdomains.</td> </tr> <tr> <td>server.index</td> <td>the default file to look for in a dir. if not found a 404 will be displayed</td> </tr> <tr> <td>server.noCache</td> <td>should the server prevent caching</td> </tr> <tr> <td>server.timeout</td> <td>the amount of time allowed for no activity on a connection before it is closed.</td> </tr> <tr> <td>contentType.*</td> <td>mapping of file extension to header Content-Type value.</td> </tr> <tr> <td>restrictedType.*</td> <td>extensions to which access will be denied.</td> </tr> <tr> <td>errors.headers</td> <td>these are the headers that will automatically be applied to all error responses. You can add custom headers per error in the <code>beforeServe</code> function</td> </tr> <tr> <td>errors.*</td> <td>error headers and error strings, these can be anything you like from html to text etc. The 500 error will replace <code>{{err}}</code> in the specified value with the actual error message from the server.</td> </tr> </tbody> </table> <h4 id="config-domains-">config.domains.*</h4> Use this object for sub domains, or hosting multiple domains on the same port. Specify the whole host i.e. “my.sub.domain.com” or “amazing-domain.com”. You may need to edit your hosts file, cnames, iptable to get this to work on your server or development environment. You can add the below example to your hosts file to run some of the examples from the <code>/example/basic</code> directory which use multiple domains on occasion. <pre><code>#node-http-server examples 127.0.0.1 myapp 127.0.0.1 a.myapp 127.0.0.1 yourapp.com </code></pre><pre><code class="lang-javascript"> const server=require('node-http-server'); const config={ port:8000, root:__dirna\me+'/appRoot/', domain:'myapp', domains:{ //subdomain 'a.myapp':`${__dirname}/appSubDomainRoot/`, //totally different domain, but also on port 8000 'yourapp.com':`${__dirname}/appOtherDomainRoot/` } } server.deploy(config); </code></pre> <hr> <h2 id="extending-the-server">Extending the Server</h2> If you wish to make a reusable Server Class of your own to share or for some internal use you can always extend the server class and make your own module too. <pre><code class="lang-javascript"> const os=require('os'); const Server=require('node-http-server').Server; class MyAwesomeServer extends Server(){ constructor(){ super(); } IP(){ const networkInterfaces = os.networkInterfaces(); const serverIPs={}; const interfaceKeys=Object.keys(networkInterfaces); for(let i in interfaceKeys){ serverIPs[ interfaceKeys[i] ]={}; const interface=networkInterfaces[ interfaceKeys[i] ]; for(let j in interface){ serverIPs[ interfaceKeys[i] ][ interface[j].family ]=interface[j].address; } } return se