summaryrefslogtreecommitdiffstats
path: root/devtools/docs/user/debugger/set_an_xhr_breakpoint/index.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
commit36d22d82aa202bb199967e9512281e9a53db42c9 (patch)
tree105e8c98ddea1c1e4784a60a5a6410fa416be2de /devtools/docs/user/debugger/set_an_xhr_breakpoint/index.rst
parentInitial commit. (diff)
downloadfirefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz
firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esrupstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r--devtools/docs/user/debugger/set_an_xhr_breakpoint/index.rst33
1 files changed, 33 insertions, 0 deletions
diff --git a/devtools/docs/user/debugger/set_an_xhr_breakpoint/index.rst b/devtools/docs/user/debugger/set_an_xhr_breakpoint/index.rst
new file mode 100644
index 0000000000..e831df49f1
--- /dev/null
+++ b/devtools/docs/user/debugger/set_an_xhr_breakpoint/index.rst
@@ -0,0 +1,33 @@
+=====================
+Set an XHR breakpoint
+=====================
+
+An XHR (XMLHttpRequest) breakpoint breaks code execution when an XHR request is dispatched so that you can examine the current state of the program. You can break on all requests or on those that include a specific URL. To turn on the feature:
+
+1. Open the debugger
+2. Click on "Pause on any URL" which acts as a wild card, causing the code to pause on any call, or,
+3. Click the plus sign next to the XHR breakpoints header, enter the URL in which you are interested, and press :kbd:`Enter`.
+
+.. note::
+
+ If you enter a key word instead of a URL, code execution will pause on any call to a URL that contains that keyword.
+
+.. image:: xhr_breakpoint.png
+ :class: border
+
+When your code breaks on an XHR request, the right hand pane will have two additional sections:
+
+**Call stack**
+ The list of functions that were executed in order to get to the currently executing code. Click on an item in the call stack to jump to the associated line in the code display.
+
+**Scopes**
+ A list of the values that are in scope in the function, method, or event handler where the break occurred.
+
+.. image:: xhr_break.png
+ :class: border
+
+
+Inline variable preview
+***********************
+
+New in Firefox 71, the :ref:`source pane <debugger_ui_tour_source_pane>` now gives you an instant preview of the variables on each line of code you've stepped through. See :ref:`Set a breakpoint > Inline variable preview <debugger-how-to-set-a-breakpoint-variable-preview>` for more information.