Neo's Playing Morpheus

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

    4.0.0 • Public • Published

    Middy http-error-handler middleware

    Middy logo

    HTTP error handler middleware for the middy framework, the stylish Node.js middleware engine for AWS Lambda

    npm version npm install size GitHub Actions CI status badge
    Standard Code Style Known Vulnerabilities Language grade: JavaScript Core Infrastructure Initiative (CII) Best Practices
    Chat on Gitter Ask questions on StackOverflow

    You can read the documentation at:

    Automatically handles uncaught errors that contain the properties statusCode (number) and message (string) and creates a proper HTTP response for them (using the message and the status code provided by the error object). Additionally, support for the property expose is included with a default value of statusCode < 500. We recommend generating these HTTP errors with the npm module http-errors. When manually catching and setting errors with statusCode >= 500 setting {expose: true} is needed for them to be handled.

    This middleware should be set as the last error handler unless you also want to register the http-response-serializer. If so, this middleware should come second-last and the http-response-serializer should come last.


    To install this middleware you can use NPM:

    npm install --save @middy/http-error-handler


    • logger (function) (default console.error) - a logging function that is invoked with the current error as an argument. You can pass false if you don't want the logging to happen.
    • fallbackMessage (string) (default undefined) - When non-http errors occur you can catch them by setting a fallback message to be used. These will be returned with a 500 status code.

    Sample usage

    import middy from '@middy/core'
    import httpErrorHandler from '@middy/http-error-handler'
    const handler = middy((event, context) => {
      throw new createError.UnprocessableEntity()
    // when Lambda runs the handler...
    handler({}, {}, (_, response) => {
        statusCode: 422,
        body: 'Unprocessable Entity'

    Middy documentation and examples

    For more documentation and examples, refers to the main Middy monorepo on GitHub or Middy official website.


    Everyone is very welcome to contribute to this repository. Feel free to raise issues or to submit Pull Requests.


    Licensed under MIT License. Copyright (c) 2017-2022 Luciano Mammino, will Farrell, and the Middy team.

    FOSSA Status


    npm i @middy/http-error-handler


    DownloadsWeekly Downloads






    Unpacked Size

    11.5 kB

    Total Files


    Last publish


    • lmammino
    • middyjs
    • willfarrell