An initialization step/middleware to let you start accepting requests immediately, but wait until some other asynchronous task have completed, such as database connections.

Usage no npm install needed!

<script type="module">
  import expressWait from '';



NPM version Dependency Status Dev Dependency Status Code Climate Build Status Coverage Status

express-wait is a module to allow your express app to beginning accepting requests as soon as the server can start listing.


When reading through The Twelve Factor App I noticed a piece on disposibility, specifically the part that says:

Processes should strive to minimize startup time. Ideally, a process takes a few seconds from the time the launch command is executed until the process is up and ready to receive requests or jobs. Short startup time provides more agility for the release process and scaling up; and it aids robustness, because the process manager can more easily move processes to new physical machines when warranted.

The app that I was working on at the time had to set up it's middleware asynchronously, which meant that the app couldn't start receiving requests until all of the middleware and database connections had been initialized.

This module provides you a way to do all those things asynchronously and start your server listening for requests immediately.


var http = require('http');
var express = require('express');
var wait = require('express-wait');
var app = express();
var server = http.createServer(app);

var PORT = process.env.PORT || 8000;
var init = wait(app);

// Insert more applicable asynchronous task here:
setTimeout(function() {
  app.use(function(req, res) {

}, 10000);

server.listen(PORT, function() {
  console.log('Server is ready to accept requests on port ', PORT);

If there is some error that happened in your initialization, pass the error as the first parameter. The error will be passed through express' error handler, so be sure you have error handling middleware to catch those errors.


Pull requests and issues welcome.