native node:fs and node:os are no more experimental (#10498)

Author: vicb

.changeset/spicy-sloths-divide.md

@@ -0,0 +1,9 @@
+---
+"@cloudflare/unenv-preset": patch
+---
+
+enabled native `node:fs` and `node:os` modules.
+
+native `node:fs` is used when the `enable_nodejs_fs_module` is set or by default starting from 2025-09-15.
+
+native `node:os` is used when the `enable_nodejs_os_module` is set or by default starting from 2025-09-15

packages/unenv-preset/package.json

@@ -49,7 +49,7 @@
 	},
 	"peerDependencies": {
 		"unenv": "2.0.0-rc.19",
-		"workerd": "^1.20250823.0"
+		"workerd": "^1.20250827.0"
 	},
 	"peerDependenciesMeta": {
 		"workerd": {

packages/unenv-preset/src/preset.ts

@@ -132,11 +132,12 @@ export function getCloudflarePreset({
  * Returns the overrides for node http modules (unenv or workerd)
  *
  * The native http implementation (excluding server APIs):
- * - is enabled after 2025-08-15
+ * - is enabled starting from 2025-08-15
  * - can be enabled with the "enable_nodejs_http_modules" flag
  * - can be disabled with the "disable_nodejs_http_modules" flag
  *
  * The native http server APIS implementation:
+ * - is enabled starting from 2025-09-15
  * - can be enabled with the "enable_nodejs_http_server_modules" flag
  * - can be disabled with the "disable_nodejs_http_server_modules" flag
  */
@@ -196,12 +197,12 @@ function getHttpOverrides({
 /**
  * Returns the overrides for `node:os` (unenv or workerd)
  *
- * The native http implementation:
+ * The native os implementation:
+ * - is enabled starting from 2025-09-15
  * - can be enabled with the "enable_nodejs_os_module" flag
  * - can be disabled with the "disable_nodejs_os_module" flag
  */
 function getOsOverrides({
-	// eslint-disable-next-line unused-imports/no-unused-vars
 	compatibilityDate,
 	compatibilityFlags,
 }: {
@@ -212,12 +213,10 @@ function getOsOverrides({
 		"disable_nodejs_os_module"
 	);
 
-	const enabledByFlag =
-		compatibilityFlags.includes("enable_nodejs_os_module") &&
-		compatibilityFlags.includes("experimental");
+	const enabledByFlag = compatibilityFlags.includes("enable_nodejs_os_module");
+	const enabledByDate = compatibilityDate >= "2025-09-15";
 
-	// TODO: add `enabledByDate` when a default date is set
-	const enabled = enabledByFlag && !disabledByFlag;
+	const enabled = (enabledByFlag || enabledByDate) && !disabledByFlag;
 
 	// The native os module implements all the APIs.
 	// It can then be used as a native module.
@@ -236,11 +235,11 @@ function getOsOverrides({
  * Returns the overrides for `node:fs` and `node:fs/promises` (unenv or workerd)
  *
  * The native fs implementation:
+ * - is enabled starting from 2025-09-15
  * - can be enabled with the "enable_nodejs_fs_module" flag
  * - can be disabled with the "disable_nodejs_fs_module" flag
  */
 function getFsOverrides({
-	// eslint-disable-next-line unused-imports/no-unused-vars
 	compatibilityDate,
 	compatibilityFlags,
 }: {
@@ -251,12 +250,10 @@ function getFsOverrides({
 		"disable_nodejs_fs_module"
 	);
 
-	const enabledByFlag =
-		compatibilityFlags.includes("enable_nodejs_fs_module") &&
-		compatibilityFlags.includes("experimental");
+	const enabledByFlag = compatibilityFlags.includes("enable_nodejs_fs_module");
+	const enabledByDate = compatibilityDate >= "2025-09-15";
 
-	// TODO: add `enabledByDate` when a default date is set
-	const enabled = enabledByFlag && !disabledByFlag;
+	const enabled = (enabledByFlag || enabledByDate) && !disabledByFlag;
 
 	// The native `fs` and `fs/promises` modules implement all the node APIs so we can use them directly
 	return enabled

packages/wrangler/e2e/unenv-preset/preset.test.ts

@@ -98,26 +98,25 @@ const testConfigs: TestConfig[] = [
 	[
 		{
 			name: "os disabled by date",
-			compatibilityDate: "2025-07-26",
-			compatibilityFlags: ["experimental"],
+			compatibilityDate: "2024-09-23",
 			expectRuntimeFlags: {
 				enable_nodejs_os_module: false,
 			},
 		},
-		// TODO: add a config when os is enabled by default (date no set yet)
+		// TODO: add a config when os is enabled by default (>= 2025-09-15)
 		{
 			name: "os enabled by flag",
-			compatibilityDate: "2025-07-26",
-			compatibilityFlags: ["enable_nodejs_os_module", "experimental"],
+			compatibilityDate: "2024-09-23",
+			compatibilityFlags: ["enable_nodejs_os_module"],
 			expectRuntimeFlags: {
 				enable_nodejs_os_module: true,
 			},
 		},
-		// TODO: change the date pass the default enabled date (date not set yet)
+		// TODO: change the date pass the default enabled date (>= 2025-09-15)
 		{
 			name: "os disabled by flag",
 			compatibilityDate: "2025-07-26",
-			compatibilityFlags: ["disable_nodejs_os_module", "experimental"],
+			compatibilityFlags: ["disable_nodejs_os_module"],
 			expectRuntimeFlags: {
 				enable_nodejs_os_module: false,
 			},
@@ -127,26 +126,25 @@ const testConfigs: TestConfig[] = [
 	[
 		{
 			name: "fs disabled by date",
-			compatibilityDate: "2025-07-26",
-			compatibilityFlags: ["experimental"],
+			compatibilityDate: "2024-09-23",
 			expectRuntimeFlags: {
 				enable_nodejs_fs_module: false,
 			},
 		},
-		// TODO: add a config when fs is enabled by default (date no set yet)
+		// TODO: add a config when fs is enabled by default (>= 2025-09-15)
 		{
 			name: "fs enabled by flag",
-			compatibilityDate: "2025-07-26",
-			compatibilityFlags: ["enable_nodejs_fs_module", "experimental"],
+			compatibilityDate: "2024-09-23",
+			compatibilityFlags: ["enable_nodejs_fs_module"],
 			expectRuntimeFlags: {
 				enable_nodejs_fs_module: true,
 			},
 		},
-		// TODO: change the date pass the default enabled date (date not set yet)
+		// TODO: change the date pass the default enabled date (>= 2025-09-15)
 		{
 			name: "fs disabled by flag",
 			compatibilityDate: "2025-07-26",
-			compatibilityFlags: ["disable_nodejs_fs_module", "experimental"],
+			compatibilityFlags: ["disable_nodejs_fs_module"],
 			expectRuntimeFlags: {
 				enable_nodejs_fs_module: false,
 			},