Use workerd node:console when available (#10606)

* Use workerd `node:console` when available

* Apply suggestion from @vicb

* fixup! stdErr, stdOut -> stderr, stdout

* fixup! bump workerd peer dep

---------

Co-authored-by: Victor Berchet <[email protected]>

Author: petebacondarwin

.changeset/calm-carrots-tie.md

@@ -0,0 +1,8 @@
+---
+"@cloudflare/unenv-preset": patch
+---
+
+Use workerd `node:console` when it is available
+
+It is enabled when the `enable_nodejs_console_module` compatibility flag is set.
+This flag defaults to true when `nodejs_compat` is turned on and the date is >= 2025-09-21.

packages/unenv-preset/package.json

@@ -49,7 +49,7 @@
 	},
 	"peerDependencies": {
 		"unenv": "2.0.0-rc.24",
-		"workerd": "^1.20251125.0"
+		"workerd": "^1.20251202.0"
 	},
 	"peerDependenciesMeta": {
 		"workerd": {

packages/unenv-preset/src/preset.ts

@@ -47,7 +47,7 @@ const nativeModules = [
 ];
 
 // Modules implemented via a mix of workerd APIs and polyfills.
-const hybridModules = ["console", "process"];
+const hybridModules = ["process"];
 
 /**
  * Creates the Cloudflare preset for the given compatibility date and compatibility flags
@@ -77,6 +77,7 @@ export function getCloudflarePreset({
 	const traceEventsOverrides = getTraceEventsOverrides(compat);
 	const domainOverrides = getDomainOverrides(compat);
 	const wasiOverrides = getWasiOverrides(compat);
+	const consoleOverrides = getConsoleOverrides(compat);
 
 	// "dynamic" as they depend on the compatibility date and flags
 	const dynamicNativeModules = [
@@ -90,6 +91,7 @@ export function getCloudflarePreset({
 		...traceEventsOverrides.nativeModules,
 		...domainOverrides.nativeModules,
 		...wasiOverrides.nativeModules,
+		...consoleOverrides.nativeModules,
 	];
 
 	// "dynamic" as they depend on the compatibility date and flags
@@ -104,6 +106,7 @@ export function getCloudflarePreset({
 		...traceEventsOverrides.hybridModules,
 		...domainOverrides.hybridModules,
 		...wasiOverrides.hybridModules,
+		...consoleOverrides.hybridModules,
 	];
 
 	return {
@@ -136,7 +139,7 @@ export function getCloudflarePreset({
 			global: false,
 			clearImmediate: false,
 			setImmediate: false,
-			console: "@cloudflare/unenv-preset/node/console",
+			...consoleOverrides.inject,
 			process: "@cloudflare/unenv-preset/node/process",
 		},
 		polyfill: ["@cloudflare/unenv-preset/polyfill/performance"],
@@ -510,3 +513,47 @@ function getWasiOverrides({
 				hybridModules: [],
 			};
 }
+
+/**
+ * Returns the overrides for `node:console` (unenv or workerd)
+ *
+ * The native console implementation:
+ * - is enabled starting from 2025-09-21
+ * - can be enabled with the "enable_nodejs_console_module" flag
+ * - can be disabled with the "disable_nodejs_console_module" flag
+ */
+function getConsoleOverrides({
+	compatibilityDate,
+	compatibilityFlags,
+}: {
+	compatibilityDate: string;
+	compatibilityFlags: string[];
+}): {
+	nativeModules: string[];
+	hybridModules: string[];
+	inject: Record<string, string>;
+} {
+	const disabledByFlag = compatibilityFlags.includes(
+		"disable_nodejs_console_module"
+	);
+
+	const enabledByFlag = compatibilityFlags.includes(
+		"enable_nodejs_console_module"
+	);
+	const enabledByDate = compatibilityDate >= "2025-09-21";
+
+	const enabled = (enabledByFlag || enabledByDate) && !disabledByFlag;
+
+	// The native `console` module implements all the node APIs so we can use them directly
+	return enabled
+		? {
+				nativeModules: ["console"],
+				hybridModules: [],
+				inject: {},
+			}
+		: {
+				nativeModules: [],
+				hybridModules: ["console"],
+				inject: { console: "@cloudflare/unenv-preset/node/console" },
+			};
+}

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

@@ -201,6 +201,39 @@ const localTestConfigs: TestConfig[] = [
 			},
 		},
 	],
+	// node:console
+	[
+		{
+			name: "console disabled by date",
+			compatibilityDate: "2024-09-23",
+			expectRuntimeFlags: {
+				enable_nodejs_console_module: false,
+			},
+		},
+		{
+			name: "console enabled by date",
+			compatibilityDate: "2025-09-21",
+			expectRuntimeFlags: {
+				enable_nodejs_console_module: true,
+			},
+		},
+		{
+			name: "console enabled by flag",
+			compatibilityDate: "2024-09-23",
+			compatibilityFlags: ["enable_nodejs_console_module"],
+			expectRuntimeFlags: {
+				enable_nodejs_console_module: true,
+			},
+		},
+		{
+			name: "console disabled by flag",
+			compatibilityDate: "2025-09-21",
+			compatibilityFlags: ["disable_nodejs_console_module"],
+			expectRuntimeFlags: {
+				enable_nodejs_console_module: false,
+			},
+		},
+	],
 	// node:process v2
 	[
 		{

packages/wrangler/e2e/unenv-preset/worker/index.ts

@@ -59,6 +59,59 @@ function generateTestListResponse(testName: string): Response {
 // Test functions executed on worked.
 // The test can be executing by fetching the `/${testName}` url.
 export const WorkerdTests: Record<string, () => void> = {
+	async testConsole() {
+		const importNamespace = await import("node:console");
+		const globalObject = globalThis.console;
+
+		assert.strictEqual(
+			globalThis.console,
+			importNamespace.default,
+			"expected `console` to be the same as `consoleImport.default`"
+		);
+
+		assertTypeOf(importNamespace, "default", "object");
+
+		for (const target of [importNamespace, globalObject]) {
+			assertTypeOfProperties(target, {
+				Console: "function",
+				assert: "function",
+				clear: "function",
+				count: "function",
+				countReset: "function",
+				debug: "function",
+				dir: "function",
+				dirxml: "function",
+				error: "function",
+				group: "function",
+				groupCollapsed: "function",
+				groupEnd: "function",
+				info: "function",
+				log: "function",
+				profile: "function",
+				profileEnd: "function",
+				table: "function",
+				time: "function",
+				timeEnd: "function",
+				timeLog: "function",
+				trace: "function",
+				warn: "function",
+				// These undocumented APIs are supported in Node.js, unenv, and workerd natively.
+				context: "function",
+				createTask: "function",
+			});
+		}
+
+		// These undocumented APIs are only on the global object not the import.
+		assertTypeOfProperties(global.console, {
+			_stderr: "object",
+			_stdout: "object",
+			_times: "object",
+			_stdoutErrorHandler: "function",
+			_stderrErrorHandler: "function",
+			_ignoreErrors: "boolean",
+		});
+	},
+
 	async testCryptoGetRandomValues() {
 		const crypto = await import("node:crypto");