summaryrefslogtreecommitdiffstats
path: root/devtools/docs/user/web_console/split_console/index.rst
diff options
context:
space:
mode:
Diffstat (limited to 'devtools/docs/user/web_console/split_console/index.rst')
-rw-r--r--devtools/docs/user/web_console/split_console/index.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/devtools/docs/user/web_console/split_console/index.rst b/devtools/docs/user/web_console/split_console/index.rst
new file mode 100644
index 0000000000..13bee8efc7
--- /dev/null
+++ b/devtools/docs/user/web_console/split_console/index.rst
@@ -0,0 +1,26 @@
+=============
+Split console
+=============
+
+You can use the console alongside other tools. While you're in another tool in the Toolbox, just press :kbd:`Esc` or select the "Show split console" command in the :ref:`Toolbar <tools-toolbox-toolbar>` menu. The toolbox will now appear split, with the original tool above and the web console underneath.
+
+You can close the split console by pressing :kbd:`Esc` again, or by selecting the "Hide split console" menu command.
+
+.. image:: split-console.png
+ :class: border
+
+.. raw:: html
+
+ <iframe width="560" height="315" src="https://www.youtube.com/embed/G2hyxhPHyXo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+ <br/>
+ <br/>
+
+As usual, ``$0`` works as a shorthand for the element currently selected in the Inspector:
+
+.. image:: split-console-debugger.png
+ :class: center
+
+When you use the split console with the debugger, the console's scope is the currently executing stack frame. So if you hit a breakpoint in a function, the scope will be the function's scope. You'll get autocomplete for objects defined in the function, and can easily modify them on the fly:
+
+.. image:: split-console-show-debug.png
+ :class: center