Skip to content

Commit bf1f6e0

Browse files
trivikrkuhe
andauthored
docs: add support policy section for Node.js/ECMAScript versions (#7556)
Co-authored-by: George Fu <[email protected]>
1 parent 731dbfe commit bf1f6e0

File tree

1 file changed

+17
-7
lines changed

1 file changed

+17
-7
lines changed

README.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Please refer to [Performance](https://github.com/aws/aws-sdk-js-v3/tree/main/sup
4848
1. [Install from Source](#install-from-source)
4949
1. [Giving feedback and contributing](#giving-feedback-and-contributing)
5050
1. [Release Cadence](#release-cadence)
51-
1. [Node.js versions](#nodejs-versions)
51+
1. [Node.js and ECMAScript Version Support Policy](#nodejs-and-ecmascript-version-support-policy)
5252
1. [Stability of Modular Packages](#stability-of-modular-packages)
5353
1. [Known Issues](#known-issues)
5454
1. [Functionality requiring AWS Common Runtime (CRT)](#functionality-requiring-aws-common-runtime-crt)
@@ -598,17 +598,27 @@ For a full middleware stack deep dive, please check out our [blog post](https://
598598
Our releases usually happen once per weekday. Each release increments the
599599
minor version, e.g. 3.200.0 -> 3.201.0.
600600

601-
## <a id="nodejs-versions"></a> Node.js versions
601+
## Node.js and ECMAScript Version Support Policy
602602

603-
v3.723.0 and higher requires Node.js >= 18.
603+
In 2025, we [announced](https://a.co/c895JFp) that JS SDK v3 will start following the Node.js release schedule for
604+
ending support for Node.js and ECMAScript versions. The Node.js LTS versions reach end-of-life (EOL) in April. We will
605+
drop support for the EOL Node.js LTS versions after 8 months of it going EOL, i.e. in the January the following year.
604606

605-
v3.567.0 and higher requires Node.js >= 16.
607+
### Node.js versions
606608

607-
v3.201.0 and higher requires Node.js >= 14.
609+
- Version released in second week of January 2026 and higher will require Node.js >= 20.
610+
- v3.723.0 and higher requires Node.js >= 18.
611+
- v3.567.0 and higher requires Node.js >= 16.
612+
- v3.201.0 and higher requires Node.js >= 14.
613+
- v3.46.0 to v3.200.0 requires Node.js >= 12.
614+
- Earlier versions require Node.js >= 10.
608615

609-
v3.46.0 to v3.200.0 requires Node.js >= 12.
616+
### ECMAScript versions
610617

611-
Earlier versions require Node.js >= 10.
618+
The browser artifacts will follow the ECMAScript versions required by supported Node.js versions. This doesn’t impact
619+
most applications because new versions of browsers are released at a much faster pace (usually every 4–6 weeks), and
620+
they are automatically updated. Also, most browser applications use bundlers, where the ECMAScript version is specified
621+
in the application bundler configuration and the bundler will transpile all dependencies to that target.
612622

613623
## Stability of Modular Packages
614624

0 commit comments

Comments
 (0)