From 4113fbbc04aad90c1541fa103c37e5a25f2c39e1 Mon Sep 17 00:00:00 2001 From: rugk Date: Tue, 19 Aug 2025 20:31:43 +0200 Subject: [PATCH 1/3] Add section to debugging.md to explain that you can also use IDEs to debug In https://github.com/firefox-devtools/vscode-firefox-debug/pull/393 I've found out, that the possibility of debugging extensions using an external program is not even mentioned at all here. I guess at least such a minimal version like this would be useful. The way how to do it is then documented there. --- src/content/documentation/develop/debugging.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/content/documentation/develop/debugging.md b/src/content/documentation/develop/debugging.md index bc8171642..e2a7ab424 100644 --- a/src/content/documentation/develop/debugging.md +++ b/src/content/documentation/develop/debugging.md @@ -420,6 +420,10 @@ If your extension could be affected by the browser restarting, such as when a se For more details, see [Testing persistent and restart features](/documentation/develop/testing-persistent-and-restart-features/). +## Debugging with an external development environment (IDE) +You can also debug your extension using an external integrated development environment (IDE). +For more details, see their respective documentation pages, e.g. [here is the one of the extension for Visual Studio Code (VSCode)](https://marketplace.visualstudio.com/items?itemName=firefox-devtools.vscode-firefox-debug). + {% endcapture %} {% include modules/one-column.liquid, id: "debugging-browser-restarts" From 045b9ad86a005623c941129885f43917f1f6e147 Mon Sep 17 00:00:00 2001 From: rugk Date: Tue, 19 Aug 2025 20:35:35 +0200 Subject: [PATCH 2/3] docs: properly make use of this capture thing (I hope) --- src/content/documentation/develop/debugging.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/src/content/documentation/develop/debugging.md b/src/content/documentation/develop/debugging.md index e2a7ab424..6bed05ee9 100644 --- a/src/content/documentation/develop/debugging.md +++ b/src/content/documentation/develop/debugging.md @@ -420,16 +420,27 @@ If your extension could be affected by the browser restarting, such as when a se For more details, see [Testing persistent and restart features](/documentation/develop/testing-persistent-and-restart-features/). +{% endcapture %} +{% include modules/one-column.liquid, + id: "debugging-browser-restarts" + content: content +%} + + + + + +{% capture content %} + ## Debugging with an external development environment (IDE) You can also debug your extension using an external integrated development environment (IDE). + For more details, see their respective documentation pages, e.g. [here is the one of the extension for Visual Studio Code (VSCode)](https://marketplace.visualstudio.com/items?itemName=firefox-devtools.vscode-firefox-debug). {% endcapture %} {% include modules/one-column.liquid, - id: "debugging-browser-restarts" + id: "debugging-with-an-external-development-environment-IDE" content: content %} - - From ff7d89778d4ff5afa6702fa3a1dbd6cde1c1c581 Mon Sep 17 00:00:00 2001 From: rebloor Date: Fri, 5 Sep 2025 04:57:09 +1200 Subject: [PATCH 3/3] Feedback update --- src/content/documentation/develop/debugging.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/src/content/documentation/develop/debugging.md b/src/content/documentation/develop/debugging.md index 6bed05ee9..35227aa99 100644 --- a/src/content/documentation/develop/debugging.md +++ b/src/content/documentation/develop/debugging.md @@ -433,9 +433,15 @@ For more details, see [Testing persistent and restart features](/documentation/d {% capture content %} ## Debugging with an external development environment (IDE) -You can also debug your extension using an external integrated development environment (IDE). -For more details, see their respective documentation pages, e.g. [here is the one of the extension for Visual Studio Code (VSCode)](https://marketplace.visualstudio.com/items?itemName=firefox-devtools.vscode-firefox-debug). +Mozilla provides a [Debug Adapter for Firefox](https://www.npmjs.com/package/firefox-debugadapter) that implements the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/). This adapter enables debug integration with any IDE that supports DAP. + +At the time of writing, September 2025, these integrations are available: + +- Visual Studio Code [Debugger for Firefox](https://marketplace.visualstudio.com/items?itemName=firefox-devtools.vscode-firefox-debug)β€”this extension is maintained by the [Firefox DevTools](https://marketplace.visualstudio.com/publishers/firefox-devtools) team. +- [Eclipse Wild Web Developer : 🌐 Web dev in Eclipse IDE 🌘](https://github.com/eclipse-wildwebdeveloper/wildwebdeveloper/) + +In addition, other DAP adapters have been reported to work, such as debugging in [Neovim](https://neovim.io/), using [nvim-dap](https://github.com/mfussenegger/nvim-dap). {% endcapture %} {% include modules/one-column.liquid,