SDK v4

[xr0master]

We decided to share new ideas for the next version of SDK with you. We would love to know your thoughts about these changes and suggestions.

1. Drop old browsers

• Convert the API to use async/await keywords.
• Use Fetch API

These changes will simplify the code and add new opportunities for future changes.

2. Headless browsers

• Don't process requests in headless browsers.

{
  blockHeadless: <true | false>,
}

Allow to block the work of automatic scripts. It will also not waste quota during QA tests.

3. Block email list

• Define a local list to block requests from a specific email address.

{
  blockList: {
    list: <block list>,
    watchVariable: <variable name>,
  },
}

In addition to the list, we need to set up the target in which dynamic variable the value is the email address.

4. Client-side limit rating

• Specify the rate limit in milliseconds.

{
  limitRate: {
    id: <string> | <page URL>,
    throttle: <number>
  },
}

The rating status will be saved in the local storage to avoid a timeout reset due to page refresh. Saved per page.
However, it will also be possible to specify a custom ID or ID for all requests from the application.

Pros of the limit rate on the client side: these requests will not consume the account quota.

5. Pass a "options" variable instead of the "publicKey"

• SDK v3 compatibility support
• Global configuration via the "init" method
• Customized configuration for each individual implementation

emailjs.init({
  blockList: {
    list: ['foo@example.com', 'bar@email.com'],
  },
});

/* other code */

emailjs.send(
  'default_service',
  'my_test_template',
  {
    sendToEmail: 'example@email.com',
  },
  {
    publicKey: 'C2JWGTestKeySomething',
    limitRate: 5000,
    blockList: {
      watchVariable: 'sendToEmail',
    },
    /* other configurations */
  },
);

[xr0master]

A new branch sdk-v4 is started

[xr0master]

Done