Class ClusteredServer

Production-ready clustered HTTP server with automatic scaling and crash recovery. Features:

  • Horizontal scaling across all CPU cores
  • Automatic worker restart on crashes
  • Zero external dependencies (no PM2 needed)
  • Pure event-driven architecture (zero timeouts)
  • Helper getters for process identification (isMainProcess, isWorkerProcess)
  • Memory leak prevention with proper event cleanup
  • Instant crash recovery without coordination delays

Hierarchy (view full)

Constructors

constructor

Accessors

isMainProcess isSSL isWorkerProcess options router server

Methods

close createContext handleError listen sendResponse

Constructors

constructor

Accessors

isMainProcess

  • get isMainProcess(): boolean

  • Check if current process is the cluster primary (main process).

    Returns boolean

    True if this is the primary process

isSSL

  • get isSSL(): boolean

  • Check if SSL/HTTPS mode is enabled.

    Returns boolean

    True if server is running in HTTPS mode

isWorkerProcess

options

router

server

  • get server(): Server<typeof IncomingMessage, typeof ServerResponse>

  • Get underlying HTTP server instance.

    Returns Server<typeof IncomingMessage, typeof ServerResponse>

    Node.js HTTP server

Methods

close

ProtectedcreateContext

ProtectedhandleError

  • handleError(err, req, res): void
  • Protected

    Handle request processing errors.

    Parameters

    • err: Error

      Error that occurred

    • req: IncomingMessage

      Original request

    • res: ServerResponse<IncomingMessage>

      Response object

    Returns void

listen

  • listen(port, host?): Promise<void>

  • Start clustered server with automatic worker management.

    Parameters

    • port: number

      Port to listen on

    • Optionalhost: string = "0.0.0.0"

      Host to bind to

    Returns Promise<void>

ProtectedsendResponse

Settings

Member Visibility

On This Page

Constructors
Accessors
Methods