docs

lambda-tester

Simplifies writing unit tests for AWS Lambda functions using Node.js.

Features

• Verifies correct handler behavior
• Works asynchronously
• AWS X-Ray support [experimental]
• Detects resource leaks [experimental]
• Verifies Node.js runtime version
• Supports Promises
• Easily integrates with test frameworks (Mocha and Jasmine)
• Handlers can be loaded and removed after execution
• Lightweight and won't impact performance
• Maps the environment variable LAMBDA_TASK_ROOT to the application's root
• Automatically loads .env files
• Works with Node 6.10.x

Table of Contents

• Installation
• Getting Started
• Verifying context.succeed(), context.fail and context.done()
• Verifying callback()
• Custom Event Values
• Resource Leak Detection
• Detecting Handlers than Run for Too Long
• Using lambda-tester with Mocha and Jasmine
• Loading handlers manually
• Using environment variables
• Configuration settings
• Node.js Version Verification

Feedback

We'd love to get feedback on how you're using lambda-tester and things we could add to make this tool better. Feel free to contact us at [email protected]

Compatibility

Version 3.x targets Lambda handlers using Node 6.10.x. If you require support for Node 4.x, please use version 2.x

License

BSD-3-Clause