Skip to content

Conversation

penalosa
Copy link
Contributor

@penalosa penalosa commented Jul 4, 2025

Summary

Add a changelog for Wrangler/Vite/Miniflare's new support for VSCode JS debug terminals

Documentation checklist

Copy link
Contributor

github-actions bot commented Jul 4, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/pcx-cloudflare-one
/src/content/docs/workers/observability/ @irvinebroque, @mikenomitch, @rohinlohe, @kodster28, @cloudflare/pcx-technical-writing

Copy link
Contributor

@vicb vicb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice!

@rita3ko
Copy link
Collaborator

rita3ko commented Jul 7, 2025

I would flip the two paragraphs and start with what's possible today and then explain why this is follow-on work from what we did in 2023

Copy link
Contributor

@irvinebroque irvinebroque left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for changelog! See comments

@@ -0,0 +1,11 @@
---
title: Support for JavaScript debug terminals in VSCode
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: Support for JavaScript debug terminals in VSCode
title: Workers now supports JavaScript debug terminals in VSCode, Cursor and Windsurf IDEs

This works beyond VSCode, and we should mention the code editors that people are using, so that people understand that not confined just to the VSCode product

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we update and reflect in copy below as well?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Totally fair. I haven't actually tested this in those IDEs, but I assume it'll work given they're VSCode forks


In 2023 we announced [breakpoint debugging support](https://blog.cloudflare.com/debugging-cloudflare-workers/) for Workers, which meant that you could easily debug your Worker code in Wrangler's built-in devtools (accessible via the `[d]` hotkey) as well as multiple other devtools clients, [including VSCode](https://developers.cloudflare.com/workers/observability/dev-tools/breakpoints/). For most developers, breakpoint debugging via VSCode is the most natural flow, but until now it's required [manually configuring a `launch.json` file](https://developers.cloudflare.com/workers/observability/dev-tools/breakpoints/#setup-vs-code-to-use-breakpoints), running `wrangler dev`, and connecting via VSCode's built-in debugger.

Now, using VSCode's built-in [JavaScript Debug Terminals](https://code.visualstudio.com/docs/nodejs/nodejs-debugging#_javascript-debug-terminal), there are just two steps: open a JS debug terminal and run `wrangler dev` (or `vite dev`). VSCode will automatically connect to your running Worker (even if you're running multiple Workers at once!) and start a debugging session.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Now, using VSCode's built-in [JavaScript Debug Terminals](https://code.visualstudio.com/docs/nodejs/nodejs-debugging#_javascript-debug-terminal), there are just two steps: open a JS debug terminal and run `wrangler dev` (or `vite dev`). VSCode will automatically connect to your running Worker (even if you're running multiple Workers at once!) and start a debugging session.
Now, using VSCode's built-in [JavaScript Debug Terminals](https://code.visualstudio.com/docs/nodejs/nodejs-debugging#_javascript-debug-terminal), there are just two steps: open a JS debug terminal (Cmd + Shift + P and then type `javascript debug`) and run `wrangler dev` (or `vite dev`) from within the debug terminal. VSCode will automatically connect to your running Worker (even if you're running multiple Workers at once!) and start a debugging session.

Suggestion to make easier to go straight into trying this out

@irvinebroque
Copy link
Contributor

Is there a corresponding update to this page?

https://developers.cloudflare.com/workers/observability/dev-tools/breakpoints/

@penalosa penalosa requested review from a team, kodster28, mikenomitch and rohinlohe as code owners July 14, 2025 17:06
@penalosa penalosa requested a review from irvinebroque July 14, 2025 17:06
@github-actions github-actions bot added the product:workers Related to Workers product label Jul 14, 2025
Copy link
Contributor

hyperlint-ai bot commented Jul 14, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Added a changelog for the new support of VSCode JavaScript debug terminals in Wrangler/Vite/Miniflare.

  • Introduced support for VSCode JavaScript debug terminals in the debugging process.
  • Updated documentation to include instructions for using debug terminals with Wrangler and Vite.

Modified Files

  • src/content/docs/workers/observability/dev-tools/breakpoints.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

Copy link
Contributor

@irvinebroque irvinebroque left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚀 👏

@penalosa penalosa enabled auto-merge (squash) July 14, 2025 17:14
@penalosa penalosa merged commit cf2980d into production Jul 14, 2025
11 checks passed
@penalosa penalosa deleted the penalosa/debug-terminals-changelog branch July 14, 2025 17:19
sdnts pushed a commit to sdnts/cloudflare-docs that referenced this pull request Jul 24, 2025
* Add debug terminals changelog

* Address comments
thomasgauvin pushed a commit that referenced this pull request Aug 15, 2025
* Add debug terminals changelog

* Address comments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

10 participants