AWS Developer Tools Blog

Announcing the end of support for Node.js <10.x in the AWS SDK for JavaScript (v2)

Starting November 1 2021, the AWS SDK For JavaScript (v2) will no longer support the following end of life (EOL) Node.js runtime versions:

  • Node.js 0.10 – EOL on 2016-10-31
  • Node.js 0.12 – EOL on 2016-12-31
  • Node.js 4.x – EOL on 2018-04-30
  • Node.js 6.x – EOL on 2019-04-30
  • Node.js 8.x – EOL on 2019-12-31

We encourage you to upgrade to Node.js 10.x or later. We recommend Node.js 14.x which was released on 2020-04-21 and became active LTS on 2020-10-27.

Modular AWS SDK for JavaScript (v3) is generally available, and it supports Node.js 10.x or later. You can also refer our Migration Guide to move your code to use v3, or visit our self-guided workshop which builds a simple note taking application using v2 and provides step-by-step migration instructions to v3.

Motivation

As Node.js <10.x versions have reached end-of-life, we are seeing support drop within the Node.js community and among some of the SDK dependencies for the EOL versions. To make sure we are providing up-to-date and secure libraries, we’re joining this migration. We encourage you to do the same to ensure your applications and services remain secure.

Usage

If you’re using AWS SDK for JavaScript (v2) in Node.js <10.x runtime versions, the following message will be shown on npm install:

$ node --version
v8.11.3

$ npm install aws-sdk

...
The AWS SDK for JavaScript (v2) will no longer support Node.js v8.11.3
as of November 1, 2021. To continue receiving updates to AWS services
and bug fixes please upgrade to Node.js 10.x or later.

More information can be found at: https://a.co/cf10B3y
...

On November 1, 2021, the CHANGELOG.md for AWS SDK for JavaScript (v2) will specify the exact SDK version where support for these runtime versions have been dropped. The installation for newer versions of AWS SDK for JavaScript (v2) will fail in Node.js <10.x as follows if you have set engine-strict=true:

$ node --version
v8.11.3

$ npm install aws-sdk
...
npm ERR! code ENOTSUPnpm ERR! notsup Unsupported engine for aws-sdk@<version>: wanted: {"node":">=10.0.0"} (current: {"node":"8.11.3","npm":"5.6.0"})
...

Maintenance Policies

The Node.js Release Schedule

Please see the Node.js release schedule for a complete list of Node.js versions and their maintenance status.

Release Schedule of Node.js runtime

The new even-numbered versions (e.g. v12.x, v14.x, v16.x etc) are cut in April, while odd-numbered versions (e.g. v13.x, v15.x) are cut in October. When a new odd-release is cut, the previous even-numbered version transitions to LTS.

AWS SDKs and Tools

For more information regarding maintenance and deprecation for AWS SDKs, please see the AWS SDKs and Tools Maintenance PolicyOur policy is to continue supporting SDK dependencies for at least 6 months after the community or vendor ends support for the dependency.

Feedback

We value your feedback, so please tell us what you like and don’t like by opening an issue on GitHub.

Trivikram Kamat

Trivikram Kamat

Trivikram is maintainer of AWS SDK for JavaScript in Node.js and browser. Trivikram is also a Node.js Core collaborator and have contributed to HTTP, HTTP/2 and HTTP/3 over QUIC implementations in the past. He has been writing JavaScript for over a decade. You can find him on Twitter @trivikram and GitHub @trivikr.