Class HandlerServerConfigurator

A ServerConfigurator that attaches an HttpHandler to the request event of a Server. All incoming requests will be sent to the provided handler. Failsafes are added to make sure a valid response is sent in case something goes wrong.

The showStackTrace parameter can be used to add stack traces to error outputs.

Hierarchy

Constructors

Properties

handler: HttpHandler

The main HttpHandler

logger: Logger = ...
showStackTrace: boolean

Methods

  • Checks if the input can be handled by this class. If it cannot handle the input, rejects with an error explaining why.

    Parameters

    • input: Server<typeof IncomingMessage, typeof ServerResponse>

      Input that could potentially be handled.

    Returns Promise<void>

    A promise resolving if the input can be handled, rejecting with an Error if not.

  • Creates a readable error message based on the error and the showStackTrace parameter.

    Parameters

    • error: unknown

    Returns string

  • Handles the given input. This may only be called if canHandle did not reject. When unconditionally calling both in sequence, consider handleSafe instead.

    Parameters

    • server: Server<typeof IncomingMessage, typeof ServerResponse>

      Input that needs to be handled.

    Returns Promise<void>

    A promise resolving when handling is finished.

  • Helper function that first runs canHandle followed by handle. Throws the error of canHandle if the data cannot be handled, or returns the result of handle otherwise.

    Parameters

    • input: Server<typeof IncomingMessage, typeof ServerResponse>

      Input data that will be handled if it can be handled.

    Returns Promise<void>

    A promise resolving if the input can be handled, rejecting with an Error if not.