/renesas

Primary LanguageJavaScriptMIT LicenseMIT

Serverless ES7 async/await

A Serverless service that adds ES7 async/await support. Part of the Serverless Stack guide.

This uses the serverless-webpack plugin and Babel. It supports:

  • ES7 syntax in your handler functions
    • Use async/await
    • And much more!
  • 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://2njfspcvna.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

Installation

To create a new Serverless project with ES7 support.

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

Enter the new directory

$ cd my-project

Install the Node.js packages

$ npm install

Usage

To run a function on your local

$ serverless invoke local --function hello

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.

How It Works

To ensure that you get all the ES7 capabilities while showing proper error messages and seamlessly integrating with the rest of your project, we do the following:

  • The webpack.config.js loads all your handlers using the slsw.lib.entries from the serverless-webpack plugin. This means that you don't have to edit the webpack.config.js when you add a new handler file.
  • Generate the sourcemaps for all the transpiled files and load the sourcemaps in each of the handler files.
  • Catch and log any unhandled exceptions to ensure that async functions can log errors.

The result is that you should see proper error messages in your CloudWatch or console logs.

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 ES7 Service is maintained by Frank Wang (@fanjiewang) & Jay V (@jayair). Subscribe to our newsletter for updates. Send us an email if you have any questions.

serverless-wise