create-listening-server
TypeScript icon, indicating that this package has built-in type declarations

2.1.0 • Public • Published

create-listening-server

npm version Build Status

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.

Getting started

Install the library in an existing project:

npm i create-listening-server

Example usage

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);
}

License

MIT

Readme

Keywords

none

Package Sidebar

Install

npm i create-listening-server

Weekly Downloads

1,315

Version

2.1.0

License

MIT

Unpacked Size

13.8 kB

Total Files

18

Last publish

Collaborators

  • avi.vahl