Promise-based API to create listening http.Server instances.
Safe creation functionality is also exposed, with automated consecutive port retries when "address in use" errors occur. Useful for tests and development mode.
Install the library in an existing project:
npm i create-listening-server
Creation of an http.Server with a specific port:
import { createListeningHttpServer } from "create-listening-server";
import express from "express";
const PORT = 3000;
async function main() {
const app = express();
app.use(/* middleware */);
const httpServer = await createListeningHttpServer(PORT, app);
}Creation of an http.Server with automated consecutive ports retries:
import { safeListeningHttpServer } from "create-listening-server";
import express from "express";
const PREFERRED_PORT = 3000;
async function main() {
const app = express();
app.use(/* middleware */);
const { httpServer, port } = await safeListeningHttpServer(PREFERRED_PORT, app);
}MIT