Set the target JS version to ES2024 (#11506)

vicb · web-flow · commit 79d30d4321b0 · 2025-12-03T20:57:41.000+01:00
diff --git a/.changeset/tasty-melons-exist.md b/.changeset/tasty-melons-exist.md
@@ -0,0 +1,7 @@
+---
+"create-cloudflare": minor
+"wrangler": minor
+"@cloudflare/vite-plugin": minor
+---
+
+Set the target JS version to ES2024
diff --git a/packages/create-cloudflare/templates/common/ts/tsconfig.json b/packages/create-cloudflare/templates/common/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
 		/* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
 		/* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
 		/* Specify what JSX code is generated. */
 		"jsx": "react-jsx" ,
 
diff --git a/packages/create-cloudflare/templates/hello-world-durable-object-with-assets/ts/tsconfig.json b/packages/create-cloudflare/templates/hello-world-durable-object-with-assets/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
     /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
     /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
     /* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/create-cloudflare/templates/hello-world-durable-object/ts/tsconfig.json b/packages/create-cloudflare/templates/hello-world-durable-object/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
 		/* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
 		/* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
 		/* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/create-cloudflare/templates/hello-world-with-assets/ts/tsconfig.json b/packages/create-cloudflare/templates/hello-world-with-assets/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
     /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
     /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
     /* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/create-cloudflare/templates/hello-world-workflows/ts/tsconfig.json b/packages/create-cloudflare/templates/hello-world-workflows/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
 		/* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
 		/* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
 		/* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/create-cloudflare/templates/hello-world/ts/tsconfig.json b/packages/create-cloudflare/templates/hello-world/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
 		/* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
 		/* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
 		/* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/create-cloudflare/templates/openapi/ts/tsconfig.json b/packages/create-cloudflare/templates/openapi/ts/tsconfig.json
@@ -3,7 +3,7 @@
 		/* Base Options: */
 		"esModuleInterop": true,
 		"skipLibCheck": true,
-		"target": "es2022",
+		"target": "es2024",
 		"verbatimModuleSyntax": false,
 		"allowJs": true,
 		"resolveJsonModule": true,
@@ -18,7 +18,7 @@
 		"moduleResolution": "Bundler",
 		"module": "es2022",
 		"noEmit": true,
-		"lib": ["es2022"],
+		"lib": ["es2024"],
 		"types": [
 			"@types/node",
 			"@types/service-worker-mock",
diff --git a/packages/create-cloudflare/templates/queues/ts/tsconfig.json b/packages/create-cloudflare/templates/queues/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
     /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
     /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
     /* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/create-cloudflare/templates/scheduled/ts/tsconfig.json b/packages/create-cloudflare/templates/scheduled/ts/tsconfig.json
@@ -3,9 +3,9 @@
 		/* Visit https://aka.ms/tsconfig.json to read more about this file */
 
     /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-		"target": "es2021",
+		"target": "es2024",
     /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-		"lib": ["es2021"],
+		"lib": ["es2024"],
     /* Specify what JSX code is generated. */
 		"jsx": "react-jsx",
 
diff --git a/packages/vite-plugin-cloudflare/src/cloudflare-environment.ts b/packages/vite-plugin-cloudflare/src/cloudflare-environment.ts
@@ -165,7 +165,10 @@ export const cloudflareBuiltInModules = [
 ];
 
 const defaultConditions = ["workerd", "worker", "module", "browser"];
-const target = "es2022";
+
+// v8 supports es2024 features as of 11.9
+// workerd uses [v8 version 14.2 as of 2025-10-17](https://developers.cloudflare.com/workers/platform/changelog/#2025-10-17)
+const target = "es2024";
 
 export function createCloudflareEnvironmentOptions({
 	workerConfig,
diff --git a/packages/wrangler/src/deployment-bundle/bundle.ts b/packages/wrangler/src/deployment-bundle/bundle.ts
@@ -43,8 +43,9 @@ const escapeRegex = (str: string) => {
 };
 
 export const COMMON_ESBUILD_OPTIONS = {
-	// Our workerd runtime uses the same V8 version as recent Chrome, which is highly ES2022 compliant: https://kangax.github.io/compat-table/es2016plus/
-	target: "es2022",
+	// v8 supports es2024 features as of 11.9
+	// workerd uses [v8 version 14.2 as of 2025-10-17](https://developers.cloudflare.com/workers/platform/changelog/#2025-10-17)
+	target: "es2024",
 	loader: { ".js": "jsx", ".mjs": "jsx", ".cjs": "jsx" },
 } as const;
 
