From 36d22d82aa202bb199967e9512281e9a53db42c9 Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sun, 7 Apr 2024 21:33:14 +0200
Subject: Adding upstream version 115.7.0esr.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 .../debugger/how_to/debug_eval_sources/index.rst   | 32 ++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 devtools/docs/user/debugger/how_to/debug_eval_sources/index.rst

(limited to 'devtools/docs/user/debugger/how_to/debug_eval_sources/index.rst')

diff --git a/devtools/docs/user/debugger/how_to/debug_eval_sources/index.rst b/devtools/docs/user/debugger/how_to/debug_eval_sources/index.rst
new file mode 100644
index 0000000000..a43dc580a2
--- /dev/null
+++ b/devtools/docs/user/debugger/how_to/debug_eval_sources/index.rst
@@ -0,0 +1,32 @@
+==================
+Debug eval sources
+==================
+
+You can debug JavaScript code that is evaluated dynamically, either as a string passed to `eval() <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval>`_ or as a string passed to the `Function <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function>`_ constructor.
+
+In the video below, we load a page containing a source like this:
+
+.. code-block:: javascript
+
+  var script = `function foo() {
+    console.log('called foo');
+  }
+  //# sourceURL=my-foo.js`;
+
+  eval(script);
+
+  var button = document.getElementById("foo");
+  button.addEventListener("click", foo, false);
+
+
+The evaluated string is given the name "my-foo.js" using the ``//# sourceURL`` directive. This source is then listed in the :ref:`source list pane <debugger-ui-tour-source-list-pane>`, and can be opened and debugged like any other source.
+
+.. raw:: html
+
+  <iframe width="560" height="315" src="https://www.youtube.com/embed/AkvN40-y1NE" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+  <br/>
+  <br/>
+
+The name of the source will also appear in stack traces appearing in the :doc:`Web Console <../../../web_console/index>`.
+
+The debugger will also stop at `debugger; <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/debugger>`_ statements in unnamed eval sources.
-- 
cgit v1.2.3