Alibaba Cloud SDK:End of support for Node.js 10.x and earlier versions in Alibaba Cloud SDK for Node.js or TypeScript

Announcement

From January 1, 2025, Alibaba Cloud SDK for Node.js or TypeScript will no longer support the following long-term support (LTS) versions that have reached the end-of-life (EOL), as announced on the Node.js official website:

• Node.js v0.10.x: Service ended on October 31, 2016.

• Node.js v0.12.x: Service ended on December 31, 2016.

• Node.js 4.x: Service ended on April 30, 2018.

• Node.js 6.x: Service ended on April 30, 2019.

• Node.js 8.x: Service ended on December 31, 2019.

• Node.js 10.x: Service ended on April 30, 2021.

In fact, the official support for Node.js 16.x has ended. However, considering the update cost of users, Alibaba Cloud decides to first end support for Node.js 10.x and earlier versions. For more information about the maintenance policies for other versions, see the SDK for Node.js version maintenance matrix section in this topic. For more information about the SDK support policies, see Alibaba Cloud SDK support policies.

Node.js even-numbered versions, such as 12.x, 14.x, and 16.x, are released in April. Node.js odd-numbered versions, such as 13.x and 15.x, are released in October. When a new odd-numbered version is released, the previous even-numbered version enters LTS.

We recommend that you update your Node.js to 12.x or a later version. We recommend that you use Node.js 20.x, which is the current LTS version. This version entered LTS on October 24, 2023 and the service for this version will end on April 30, 2026.

Alibaba Cloud SDK guarantees support for the latest LTS version of Node.js. For more information about the complete list of Node.js versions and their maintenance status, see the Release Schedule of Node.js.

Why will Alibaba Cloud end support for Node.js 10.x and earlier versions?

Node.js 10.x and earlier versions reached EOL on April 30, 2021. Less support is available for these EOL versions in the Node.js community and for some SDK dependencies that use the EOL versions. Alibaba Cloud decides to end support for these EOL versions to ensure that Alibaba Cloud SDK provides up-to-date and secure libraries. To ensure that your applications and services remain secure, update your Node.js to a supported version, such as 20.x.

What does end-of-support mean?

If you use Alibaba Cloud SDK for Node.js in a Node.js runtime earlier than 10.x, the following information is displayed after you run the npm install command:

$ node --version
v10.24.1

$ npm install @alicloud/ecs20140526

...
NodeDeprecationWarning: The Alibaba Cloud SDK SDK for Node.js/TypeScript will
no longer support Node.js <= v10.x on January 1, 2025. To continue receiving updates to Alibaba Cloud services
and bug fixes please upgrade to Node.js 12.x or later.

From January 1, 2025, Alibaba Cloud will update the CHANGELOG.md file to indicate that Node.js 10.x and earlier versions are no longer supported. In addition, the release notes of Alibaba Cloud SDK for Node.js at GitHub and the release notes of NPM will be updated to contain the end-of-support information for Node.js 10.x. If you set the engine-strict parameter to true, an NPM installation error with the error code ENOTSUP is reported when you install Alibaba Cloud SDK in an Node.js runtime whose version is earlier than 10.x. The following code shows the error information:

$ node --version
v10.24.1

$ npm install @alicloud/ecs20140526
...
npm ERR! code ENOTSUP
npm ERR! notsup 
Unsupported engine for @alicloud/ecs20140526@<version>: wanted: {"node":">=12.0.0"} (current: {"node":"v10.24.1","npm":"7.10.0"})
...

SDK for Node.js version maintenance matrix

For more information about the maintenance and end-of-support for Alibaba Cloud SDK, see Alibaba Cloud SDK support policies. Alibaba Cloud provides support for SDK dependencies for at least six months after the community or vendor ends support for the dependencies. This policy may vary depending on the dependency. For most dependencies, the period is about one year.

The following table describes the end-of-support dates for Node.js versions in Alibaba Cloud SDK for Node.js.

What if I need extra help?

If you have any questions, submit your feedback in OpenAPI Portal or contact us by joining the DingTalk group (ID 60965016010).