¿Cómo cierro programáticamente una instancia de ExpressJS para realizar pruebas?

Estoy tratando de averiguar cómo cerrar una instancia de Express. Básicamente, quiero lo contrario de la .listen(port)llamada: ¿cómo hago para que un servidor Express DEJE de escuchar, libere el puerto y se apague limpiamente?

Sé que parece que puede ser una consulta extraña, así que aquí está el contexto; tal vez haya otra forma de abordar esto y lo estoy pensando de manera incorrecta. Estoy intentando configurar un marco de prueba para mi aplicación socket.io/nodejs. Es una aplicación de una sola página, así que en mis scripts de prueba (estoy usando Mocha, pero eso realmente no importa) Quiero poder iniciar el servidor, ejecutar pruebas en él y luego apagar el servidor. Puedo solucionar esto asumiendo que el servidor está encendido antes de que comience la prueba o haciendo que una de las pruebas inicie el servidor y que cada prueba posterior asuma que está funcionando, pero eso es realmente complicado. Preferiría que cada archivo de prueba inicie una instancia de servidor con la configuración adecuada y luego cierre esa instancia cuando terminen las pruebas. Eso significa que no hay dependencias extrañas para ejecutar la prueba y todo está limpio. También significa que puedo hacer pruebas de inicio / apagado.

Entonces, ¿algún consejo sobre cómo hacer esto? He pensado en activar excepciones manualmente para eliminarlo, pero eso parece complicado. He revisado los documentos y la fuente de Express, pero parece que no puedo encontrar ningún método que apague el servidor. También podría haber algo en socket.io para esto, pero dado que el servidor de socket está conectado al servidor Express, creo que esto debe suceder en la capa express.

Las cosas han cambiado porque el servidor express ya no hereda del servidor http del nodo. Afortunadamente, app.listen devuelve la instancia del servidor.

var server = app.listen(3000);

// listen for an event
var handler = function() {
  server.close();
};

Utilice app.close(). Ejemplo completo:

var app = require('express').createServer();
app.get('/', function(req, res){
  res.send('hello world');
});
app.get('/quit', function(req,res) {
  res.send('closing..');
  app.close();
});
app.listen(3000);

Llame app.close()dentro de la devolución de llamada cuando las pruebas hayan terminado. Pero recuerde que el proceso aún se está ejecutando (aunque ya no se escucha).

Si después de esto, necesita finalizar el proceso, llame process.exit(0).

Enlaces:

app.close: http://nodejs.org/docs/latest/api/http.html#server.close (se aplica lo mismo)

process.exit: http://nodejs.org/docs/latest/api/process.html#process.exit

He respondido una variación de "cómo terminar un servidor HTTP" muchas veces en diferentes node.jscanales de apoyo. Desafortunadamente, no pude recomendar ninguna de las bibliotecas existentes porque faltan de una manera u otra. Desde entonces, he creado un paquete que (creo) está manejando todos los casos que se esperan de una terminación elegante del servidor HTTP.

https://github.com/gajus/http-terminator

El principal beneficio de http-terminator es que:

• no aplica un parche a la API de Node.js
• inmediatamente destruye todos los sockets sin una solicitud HTTP adjunta
• permite un tiempo de espera elegante para los sockets con solicitudes HTTP en curso
• maneja correctamente las conexiones HTTPS
• informa a las conexiones mediante Keep-Alive que el servidor se está cerrando estableciendo una conexión: cerrar encabezado
• no finaliza el proceso de Node.js

Uso con Express.js:

import express from 'express';
import {
  createHttpTerminator,
} from 'http-terminator';

const app = express();

const server = app.listen();

const httpTerminator = createHttpTerminator({
  server,
});

await httpTerminator.terminate();

//... some stuff 

var server = app.listen(3000);
server.close();

Puede hacer esto fácilmente escribiendo un script bash para iniciar el servidor, ejecutar las pruebas y detener el servidor. Esto tiene la ventaja de permitirle asignar un alias a ese script para ejecutar todas sus pruebas rápida y fácilmente.

Utilizo estos scripts para todo mi proceso de implementación continua. Debería consultar el flujo de trabajo Dead Simple Git de Jon Rohan para obtener información sobre esto.