fcheong3b / serverless-nodejs-starter

A Node.js starter for the Serverless Framework with async/await and unit test support

Serverless Node.js Starter

A Serverless starter that adds ES7 async/await and unit test support. Part of the Serverless Stack guide.

Serverless Node.js Starter uses the serverless-webpack plugin, Babel, and Jest. It supports:

• ES7 syntax in your handler functions
  • Use async/await
  • And much more!
• Support for unit tests
  • Run npm test to run your tests
• Sourcemaps for proper error messages
  • Error message show the correct line numbers
  • Works in production with CloudWatch
• Automatic support for multiple handler files
  • No need to add a new entry to your webpack.config.js

If you'd like to learn how to setup your existing Serverless project to support ES7 async/await, use this guide on Serverless-Stack.com.

---

Demo

A demo version of this service is hosted on AWS - https://cvps1pt354.execute-api.us-east-1.amazonaws.com/dev/hello

And here is the ES7 source behind it

export const hello = async (event, context, callback) => {
  const response = {
    statusCode: 200,
    body: JSON.stringify({
      message: `Go Serverless v1.0! ${(await message({ time: 1, copy: 'Your function executed successfully!'}))}`,
      input: event,
    }),
  };

  callback(null, response);
};

const message = ({ time, ...rest }) => new Promise((resolve, reject) => 
  setTimeout(() => {
    resolve(`${rest.copy} (with a delay)`);
  }, time * 1000)
);

Requirements

• Install the Serverless Framework
• Configure your AWS CLI

Installation

To create a new Serverless project with ES7 support.

$ serverless install --url https://github.com/AnomalyInnovations/serverless-nodejs-starter --name my-project

Enter the new directory

$ cd my-project

Install the Node.js packages

$ npm install

Usage

To run unit tests on your local

$ npm test

To run a function on your local

$ serverless invoke local --function hello

Run your tests

$ npm test

We use Jest to run our tests. You can read more about setting up your tests here.

Deploy your project

$ serverless deploy

Deploy a single function

$ serverless deploy function --function hello

To add another function as a new file to your project, simply add the new file and add the reference to serverless.yml. The webpack.config.js automatically handles functions in different files.

Support

• Send us an email if you have any questions
• Open a new issue if you've found a bug or have some suggestions.
• Or submit a pull request!

Maintainers

Serverless Node.js Starter is maintained by Frank Wang (@fanjiewang) & Jay V (@jayair). Subscribe to our newsletter for updates. Send us an email if you have any questions.