feat: add config.keep_names option

[dario-piotrowicz]

adds a new option so that developers can opt out of esbuild's keep_names option
(see: https://esbuild.github.io/api/#keep-names) which wrangler otherwise sets
to true

this is something developers should not usually need to care about, but sometimes
keep_names can create issues, in such cases they will be now able to opt out of it

---

This should fix:

• [BUG] Nesting Layouts with next-themes opennextjs/opennextjs-cloudflare#511
• 🐛 BUG: ReferenceError: __name is not defined in await page.evaluate(async () => {...} #7107
• and also the flashing issue I'm encountering in Make site work with the Cloudflare OpenNext adapter nodejs/nodejs.org#7383

---

• Tests
  • TODO (before merge)
  • Tests included
  • Tests not necessary because:
• Wrangler / Vite E2E Tests CI Job required? (Use "e2e" label or ask maintainer to run separately)
  • I don't know
  • Required
  • Not required because:
• Public documentation
  • TODO (before merge)
  • Cloudflare docs PR(s): add keep_names option to wrangler config docs cloudflare-docs#21896
  • Documentation not necessary because:
• Wrangler V3 Backport
  • TODO (before merge)
  • Wrangler PR:
  • Not necessary because: new Wrangler feature

[changeset-bot]

🦋 Changeset detected

Latest commit: dd3eb6e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
wrangler	Minor
@cloudflare/vitest-pool-workers	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

A wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-wrangler-8771

You can reference the automatically updated head of this PR with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/prs/8771/npm-package-wrangler-8771

Or you can use npx with this latest build directly:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-wrangler-8771 dev path/to/script.js

Additional artifacts:

cloudflare-workers-bindings-extension:

wget https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-workers-bindings-extension-8771 -O ./cloudflare-workers-bindings-extension.0.0.0-ve3deae81b.vsix && code --install-extension ./cloudflare-workers-bindings-extension.0.0.0-ve3deae81b.vsix

create-cloudflare:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-create-cloudflare-8771 --no-auto-update

@cloudflare/kv-asset-handler:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-kv-asset-handler-8771

miniflare:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-miniflare-8771

@cloudflare/pages-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-pages-shared-8771

@cloudflare/unenv-preset:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-unenv-preset-8771

@cloudflare/vite-plugin:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-vite-plugin-8771

@cloudflare/vitest-pool-workers:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-vitest-pool-workers-8771

@cloudflare/workers-editor-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-workers-editor-shared-8771

@cloudflare/workers-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-workers-shared-8771

@cloudflare/workflows-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14246394624/npm-package-cloudflare-workflows-shared-8771

Note that these links will no longer work once the GitHub Actions artifact expires.

---

[email protected] includes the following runtime dependencies:

Package	Constraint	Resolved
miniflare	workspace:*	4.20250321.1
workerd	1.20250321.0	1.20250321.0
workerd --version	1.20250321.0	2025-03-21

Please ensure constraints are pinned, and miniflare/workerd minor versions match.

[penalosa]

This could do with a test, but otherwise LGTM

[dario-piotrowicz]

This could do with a test

of course I wasn't planning on skipping on the testing 😄👍
(that's why it's still in draft, I also do need to add this in our docs)

but otherwise LGTM

thanks! 🫶

[github-actions]

A Wrangler prerelease is available for testing. You can install this latest build in your project with:

npm install --save-dev https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-wrangler-8771

Prereleases for other packages:

cloudflare-workers-bindings-extension:

wget https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-workers-bindings-extension-8771 -O ./cloudflare-workers-bindings-extension.0.0.0-vc759b05ba.vsix && code --install-extension ./cloudflare-workers-bindings-extension.0.0.0-vc759b05ba.vsix

create-cloudflare:

npx https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-create-cloudflare-8771 --no-auto-update

@cloudflare/kv-asset-handler:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-kv-asset-handler-8771

miniflare:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-miniflare-8771

@cloudflare/pages-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-pages-shared-8771

@cloudflare/unenv-preset:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-unenv-preset-8771

@cloudflare/vite-plugin:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-vite-plugin-8771

@cloudflare/vitest-pool-workers:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-vitest-pool-workers-8771

@cloudflare/workers-editor-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-workers-editor-shared-8771

@cloudflare/workers-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-workers-shared-8771

@cloudflare/workflows-shared:

npm install https://prerelease-registry.devprod.cloudflare.dev/workers-sdk/runs/14599173985/npm-package-cloudflare-workflows-shared-8771

Note that these links will no longer work once the GitHub Actions artifact expires.

[dario-piotrowicz]

This could do with a test, but otherwise LGTM

Tests added 🙂 , I didn't go overboard and just added a minimal one, please let me know if you think that this is sufficient or if you believe that we'd want more testing around this 🙂

[petebacondarwin]

Nice! Thanks.