@ionaru/web-server v4.2.0

@ionaru/web-server

Description

A package for creating a simple web server.

Usage

npm install @ionaru/web-server

Standard http

new WebServer((request, response) => {
    // Handle request
}, 3000).listen();

Express

const expressApplication = express();

expressApplication.use('/', (request, response) => {
    // Handle request
});

new WebServer(expressApplication, 3000).listen();

Separate listening call

const webServer = new WebServer((request, response) => {}, 3000);

webServer.server.on('listening', () => {/* Custom on-listening code */});
webServer.listen();

API

WebServer.prototype.server

The created http.Server instance is exposed in the WebServer instance.

const myServer = new WebServer((request, response) => {}, 3000).listen();
myServer.server.address();

WebServer.prototype.infoLogEvent

Info-level log event

// Full-size
const myServer = new WebServer((request, response) => {}, 3000);
myServer.infoLogEvent.on((message) => {
    console.log(message);
});

// Shorthand
const myServer = new WebServer((request, response) => {}, 3000);
myServer.infoLogEvent.on(console.log);

WebServer.prototype.errorLogEvent

Error-level log event This package exposes log levels as events so you can pipe them to your favourite log handler

// Full-size
const myServer = new WebServer((request, response) => {}, 3000);
myServer.errorLogEvent.on((message) => {
    console.error(message);
});

// Shorthand
const myServer = new WebServer((request, response) => {}, 3000);
myServer.errorLogEvent.on(console.error);

WebServer.prototype.listen()

Start listening on the created web server.

const myServer = new WebServer((request, response) => {}, 3000);
myServer.listen();

WebServer.prototype.close() (async)

An promisified version of the standard .close(callback)

const myServer = new WebServer((request, response) => {}, 3000).listen();
await myServer.close();

The promise will emit an error when the server was not open when closed.

const myServer = new WebServer((request, response) => {}, 3000).listen();
await myServer.close().catch((error) => {
    // handle error
});