simple-server-setup

A library for creating a simple server with little effort.

Bootstrap an express app in just a few lines. Useful for testing scripts that use a HTTP client e.g. go-fetch or browserbot.

Installation

npm install --save-dev simple-server-setup

Usage

A simple HTTP server:

 
const server = require('simple-server-setup');
 
server.create(app => {
 
    app.get('/', (req, res) => {
      res.send('http - simple-server-setup');
    });
 
  })
  .then(server => console.log(`Listening at ${server.url}`))
;
 
 

A simple HTTPS server:

 
const server = require('simple-server-setup');
 
const options = {
  secure: true,
  key: __dirname + '/server.key',
  cert: __dirname + '/server.cert'
};
 
server.create(options, app => {
 
    app.get('/', (req, res) => {
      res.send('https - simple-server-setup');
    });
 
  })
  .then(server => console.log(`Listening at ${server.url}`))
;
 

A unit test to check the HTTP client has sent the Content-Type header:

 
const assert  = require('assert');
const client  = require('go-fetch');
const server  = require('simple-server-setup');
 
it('should set the Content-Type', function (done) {
 
  server.create(app => {
    app.get('/', (req, res) => {
      try {
        assert.equal(req.headers['content-type'], 'text/x-foo');
      } catch (err) {
        done(err);
      }
      res.send('test - simple-server-setup');
    });
  })
    .then(server => {
      client().get(server.url, {'Content-Type': 'text/x-foo'}, (err, res) => {
        if (err) throw err;
        res.getBody().on('data', () => {/* do nothing */
        });
        res.getBody().on('end', () => server.close(done));
      });
 
    })
    .catch(err => console.log(err))
  ;
 
});
 

API

Methods

.create([options], callback) : Promise<http.Server>

Create a new server with the specified options.

Options:

 @param   {Object}    [options]             The server options
 @param   {Boolean}   [options.host]        The server host - localhost
 @param   {Boolean}   [options.port]        The server port - 3000
 @param   {Boolean}   [options.keepAlive]   Whether the server should keep connections alive (turning this on will take longer for the server to shutdown between tests - false
 @param   {Boolean}   [options.secure]      Whether the server should serve requests on HTTPS - false
 @param   {Boolean}   [options.key]         The path to the server key - server.key
 @param   {Boolean}   [options.cert]        The path to the server certificate - server.cert
 @param   {Function}  callback              A function to configure the express instance

Events

Miscellaneous

Generating a self-signed key and certificate for a HTTPS server

openssl req -nodes -new -x509 -keyout server.key -out server.cert

Change log

0.2.0

• break: return a promise instead of an event emitter

License

The MIT License (MIT)

Copyright (c) 2016 James Newell