From db0476084d0797cb2f0b9f9fb66c98966f7a4fd6 Mon Sep 17 00:00:00 2001 From: Dario Piotrowicz Date: Thu, 21 Aug 2025 12:35:26 +0100 Subject: [PATCH 1/3] Simplify ENOENT debug logs for `.env` files --- .changeset/green-bugs-shout.md | 5 +++++ packages/wrangler/src/__tests__/dev.test.ts | 11 +++++++++++ packages/wrangler/src/config/dot-env.ts | 8 +++++++- 3 files changed, 23 insertions(+), 1 deletion(-) create mode 100644 .changeset/green-bugs-shout.md diff --git a/.changeset/green-bugs-shout.md b/.changeset/green-bugs-shout.md new file mode 100644 index 000000000000..2e48c1609c10 --- /dev/null +++ b/.changeset/green-bugs-shout.md @@ -0,0 +1,5 @@ +--- +"wrangler": patch +--- + +Simplify ENOENT debug logs for `.env` files diff --git a/packages/wrangler/src/__tests__/dev.test.ts b/packages/wrangler/src/__tests__/dev.test.ts index b41373492799..645630880925 100644 --- a/packages/wrangler/src/__tests__/dev.test.ts +++ b/packages/wrangler/src/__tests__/dev.test.ts @@ -1118,6 +1118,17 @@ describe.sequential("wrangler dev", () => { __DOT_ENV_TEST_CUSTOM_BUILD_VAR_LOCAL=other-local" `); }); + + it("should show reasonable debug output if `.env` does not exist", async () => { + fs.rmSync(".env"); + writeWranglerConfig({ + main: "index.js", + }); + await runWranglerUntilConfig("dev --log-level debug"); + expect(std.debug).toContain( + '.env file not found at "/.env". Continuing... For more details, refer to https://developers.cloudflare.com/workers/wrangler/system-environment-variables/' + ); + }); }); }); diff --git a/packages/wrangler/src/config/dot-env.ts b/packages/wrangler/src/config/dot-env.ts index a890878de844..086729239f00 100644 --- a/packages/wrangler/src/config/dot-env.ts +++ b/packages/wrangler/src/config/dot-env.ts @@ -49,7 +49,13 @@ export function loadDotEnv( override: true, }); if (error) { - logger.debug(`Failed to load .env file "${envPath}":`, error); + if ((error as unknown as { code: string }).code === "ENOENT") { + logger.debug( + `.env file not found at "${envPath}". Continuing... For more details, refer to https://developers.cloudflare.com/workers/wrangler/system-environment-variables/` + ); + } else { + logger.debug(`Failed to load .env file "${envPath}":`, error); + } } else if (parsed && !silent) { const relativePath = path.relative(process.cwd(), envPath); logger.log(`Using vars defined in ${relativePath}`); From cbc7c3b783b197729b38b637efe3a35a186de2ae Mon Sep 17 00:00:00 2001 From: Dario Piotrowicz Date: Tue, 26 Aug 2025 16:36:47 +0100 Subject: [PATCH 2/3] Update packages/wrangler/src/config/dot-env.ts Co-authored-by: Yagiz Nizipli --- packages/wrangler/src/config/dot-env.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/wrangler/src/config/dot-env.ts b/packages/wrangler/src/config/dot-env.ts index 086729239f00..b95da0f5ce0c 100644 --- a/packages/wrangler/src/config/dot-env.ts +++ b/packages/wrangler/src/config/dot-env.ts @@ -49,7 +49,7 @@ export function loadDotEnv( override: true, }); if (error) { - if ((error as unknown as { code: string }).code === "ENOENT") { + if ('code' in error && error.code === "ENOENT") { logger.debug( `.env file not found at "${envPath}". Continuing... For more details, refer to https://developers.cloudflare.com/workers/wrangler/system-environment-variables/` ); From 0fbc15abd452db86a29d7f5b79a500783564077c Mon Sep 17 00:00:00 2001 From: Dario Piotrowicz Date: Tue, 26 Aug 2025 18:28:06 +0100 Subject: [PATCH 3/3] fix formatting --- packages/wrangler/src/config/dot-env.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/wrangler/src/config/dot-env.ts b/packages/wrangler/src/config/dot-env.ts index b95da0f5ce0c..7d6a1f3b3cb8 100644 --- a/packages/wrangler/src/config/dot-env.ts +++ b/packages/wrangler/src/config/dot-env.ts @@ -49,7 +49,7 @@ export function loadDotEnv( override: true, }); if (error) { - if ('code' in error && error.code === "ENOENT") { + if ("code" in error && error.code === "ENOENT") { logger.debug( `.env file not found at "${envPath}". Continuing... For more details, refer to https://developers.cloudflare.com/workers/wrangler/system-environment-variables/` );