feat!: drop support for node 18.x and 19.x (#7332)

khendrikse · web-flow · commit e230a5455841 · 2025-06-05T14:51:38.000+02:00
* feat: drop support for node 18.x and 19.x

* feat: minimum version of 20.12.2

* feat: remove mention of 18.17.0 and 18.13.0

---------

Co-authored-by: Karin &lt;=&gt;
diff --git a/.github/workflows/e2e-tests.yml b/.github/workflows/e2e-tests.yml
@@ -21,7 +21,7 @@ jobs:
       matrix:
         os: [windows-latest]
         # Pinning 20.x version as a temporary workaround due to this https://github.com/nodejs/node/issues/52884
-        node-version: ['18.14.0', '20.12.2', '22']
+        node-version: ['20.12.2', '22']
       fail-fast: false
     steps:
       # This improves Windows network performance. We need this since we open many ports in our tests.
@@ -79,7 +79,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macOS-latest]
-        node-version: ['18.14.0', '22']
+        node-version: ['20.12.2', '22']
       fail-fast: false
     steps:
       - name: Git checkout
diff --git a/.github/workflows/format.yml b/.github/workflows/format.yml
@@ -19,7 +19,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.14.0
+          node-version: 20.12.2
           cache: npm
 
       - name: Install dependencies
diff --git a/.github/workflows/integration-tests.yml b/.github/workflows/integration-tests.yml
@@ -19,14 +19,10 @@ jobs:
       matrix:
         os: [ubuntu-latest, macOS-latest, windows-latest]
         # Pinning 20.x version as a temporary workaround due to this https://github.com/nodejs/node/issues/52884
-        node-version: ['18.17.0', '20.12.2', '22']
+        node-version: ['20.12.2', '22']
         shard: ['1/4', '2/4', '3/4', '4/4']
 
         exclude:
-          - os: macOS-latest
-            node-version: '18.17.0'
-          - os: windows-latest
-            node-version: '18.17.0'
           - os: windows-latest
             node-version: '22'
       fail-fast: false
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
@@ -19,7 +19,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.14.0
+          node-version: 20.12.2
           cache: npm
 
       - name: Install dependencies
diff --git a/.github/workflows/pre-release-sha.yml b/.github/workflows/pre-release-sha.yml
@@ -22,7 +22,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: '18.17.0'
+          node-version: '20.12.2'
           cache: npm
           registry-url: 'https://registry.npmjs.org'
 
diff --git a/.github/workflows/typecheck.yml b/.github/workflows/typecheck.yml
@@ -18,7 +18,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18.14.0
+          node-version: 20.12.2
           cache: npm
 
       - name: Install dependencies
diff --git a/.github/workflows/unit-tests.yml b/.github/workflows/unit-tests.yml
@@ -17,7 +17,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macOS-latest, windows-latest]
-        node-version: ['18.14.0', '22.x']
+        node-version: ['20.12.2', '22.x']
         exclude:
           - os: windows-latest
             node-version: '22.x'
diff --git a/README.md b/README.md
@@ -48,8 +48,8 @@ See the [CLI command line reference](https://cli.netlify.com/commands/) to get s
 
 ## Installation
 
-Netlify CLI requires [Node.js](https://nodejs.org) version 18.14.0 or above. To install, run the following command from any
-directory in your terminal:
+Netlify CLI requires [Node.js](https://nodejs.org) version 20.12.2 or above. To install, run the following command from
+any directory in your terminal:
 
 ```bash
 npm install netlify-cli -g
@@ -87,7 +87,6 @@ netlify [command] help
 To learn how to log in to Netlify and start deploying projects, visit the
 [documentation on Netlify](https://docs.netlify.com/cli/get-started/).
 
-
 ## Commands
 
 For a full command reference visit [cli.netlify.com](https://cli.netlify.com/).
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -5,7 +5,7 @@
   "author": "Netlify Inc.",
   "type": "module",
   "engines": {
-    "node": ">=18.14.0"
+    "node": ">=20.12.2"
   },
   "files": [
     "/bin",
diff --git a/site/package-lock.json b/site/package-lock.json
diff --git a/src/lib/functions/netlify-function.ts b/src/lib/functions/netlify-function.ts
@@ -25,7 +25,7 @@ export type InvokeFunctionResultWithSuccess = { error: null; result: InvokeFunct
 export type InvokeResult = InvokeFunctionResultWithError | InvokeFunctionResultWithSuccess
 
 const TYPESCRIPT_EXTENSIONS = new Set(['.cts', '.mts', '.ts'])
-const V2_MIN_NODE_VERSION = '18.14.0'
+const V2_MIN_NODE_VERSION = '20.12.2'
 
 // See https://github.com/microsoft/TypeScript/issues/54451.
 // Omit<A | B> does not work as you'd expect. This does.
diff --git a/src/utils/nodejs-compile-cache.ts b/src/utils/nodejs-compile-cache.ts
@@ -17,7 +17,7 @@ export let didEnableCompileCache = false
  * user's disk in a temp dir. If any of these changes or the temp dir is cleared, the next run is a cold run.
  *
  * The programmatic API to enable this (`enableCompileCache()`) was added in node 22.8.0, but we currently support
- * >=18.14.0, hence the conditional below. (For completeness, note that support via the env var was added in 22.1.0.)
+ * >=20.12.2, hence the conditional below. (For completeness, note that support via the env var was added in 22.1.0.)
  *
  * The Netlify CLI is often used in CI workflows. In this context, we wouldn't want the overhead of the first run
  * because we almost certainly would not get any benefits on "subsequent runs". Even if the user has configured caching
diff --git a/tests/integration/commands/dev/dev.config.test.ts b/tests/integration/commands/dev/dev.config.test.ts
@@ -459,7 +459,7 @@ describe.concurrent('commands/dev/config', () => {
     })
   })
 
-  test.runIf(gte(version, '18.14.0'))('should support functions with streaming responses', async (t) => {
+  test.runIf(gte(version, '20.12.2'))('should support functions with streaming responses', async (t) => {
     await withSiteBuilder(t, async (builder) => {
       builder
         .withPackageJson({ packageJson: { dependencies: { '@netlify/functions': 'latest' } } })
diff --git a/tests/integration/commands/dev/v2-api.test.ts b/tests/integration/commands/dev/v2-api.test.ts
@@ -25,7 +25,7 @@ const setup = async ({ fixture }: { fixture: { directory: string } }) => {
   await execa('npm', ['install'], { cwd: fixture.directory })
 }
 
-describe.runIf(gte(version, '18.13.0')).concurrent('v2 api', async () => {
+describe.runIf(gte(version, '20.12.2')).concurrent('v2 api', async () => {
   await setupFixtureTests('dev-server-with-v2-functions', { devServer: true, mockApi: { routes }, setup }, () => {
     test<FixtureTestContext>('should successfully be able to run v2 functions', async ({ devServer, expect }) => {
       const response = await fetch(`http://localhost:${devServer!.port}/.netlify/functions/ping`)
