lambda-edge-server

lambda-edge-server

AWS CloudFront Lambda@Edge function handler emulator.

Provides a translation layer between Node.js HTTP server and Lambda function response format. The goal is simplify local testing without the need for complex dependencies.

Dependencies

• Node.js

Installation

Install this package using NPM:

$ npm install lambda-edge-server

Lambda function handlers

The following origin-request/origin-response format is currently supported.

Synchronous example

/**
 * @see AWS::Serverless::Function
 */
exports.handler = function(event, context, callback) {
  const response = {
    status: '200',
    statusDescription: 'OK',
    headers: {
      'cache-control': [{
        key: 'Cache-Control',
        value: 'max-age=0'
      }],
      'content-type': [{
        key: 'Content-Type',
        value: 'text/html'
      }]
    },
    body: 'Success',
  };

  callback(null, response);
};

Asynchronous example

/**
 * @see AWS::Serverless::Function
 */
exports.handler = async function(event) {
  const response = {
    status: '200',
    statusDescription: 'OK',
    headers: {
      'cache-control': [{
        key: 'Cache-Control',
        value: 'max-age=0'
      }],
      'content-type': [{
        key: 'Content-Type',
        value: 'text/html'
      }]
    },
    body: 'Success',
  };

  return response;
};

Developers

CLI options

Launch HTTP server instance, run the function:

$ npm start ./path/to/script.js

Run ESLint on project sources:

$ npm run lint

Run Mocha integration tests:

$ npm run test

References

• Example origin request
• Example origin-response

AWS changes starting in Node.js 24

Going forward, it is recommended that you build your L³ application using async handlers in anticipation of the AWS changes below.

AWS Lambda plans to remove support for callback-based function handlers starting with Node.js 24. You will need to update this function to use an async handler to use Node.js 24 or later. For more information and to provide feedback on this change, see aws/aws-lambda-nodejs-runtime-interface-client#137

While backwards compatibity will be supported for older Node.js releases this support will eventually be phased out with the deprecation of nodejs22.x (Apr 30, 2027).

See AWS Node.js Supported Runtimes for support information.

Contributions

If you fix a bug, or have a code you want to contribute, please send a pull-request with your changes. (Note: Before committing your code please ensure that you are following the Node.js style guide)

Versioning

This package is maintained under the Semantic Versioning guidelines.

License and Warranty

This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

lambda-edge-server is provided under the terms of the MIT license

AWS is a registered trademark of Amazon Web Services, Inc.

Author

Marc S. Brooks