Adding upstream version 110.0.1.upstream/110.0.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 103 insertions, 0 deletions

diff --git a/devtools/docs/contributor/tests/performance-tests-overview.md b/devtools/docs/contributor/tests/performance-tests-overview.md
new file mode 100644
index 0000000000..20a9716a24
--- /dev/null
+++ b/devtools/docs/contributor/tests/performance-tests-overview.md
@@ -0,0 +1,103 @@
+# DevTools Performance Tests overview
+
+This page provides a short overview of the various DevTools performance tests.
+
+## damp
+
+DAMP (short for DevTools At Maximum Performance) is the main DevTools performance test suite, based on the talos framework. It mostly runs end to end scenarios, opening the toolbox, various panels and interacting with the UI. It might regress for a wide variety of reasons: DevTools frontend changes, DevTools server changes, platform changes etc. To investigate DAMP regressions or improvements, it is usually necessary to analyze DAMP subtests individually.
+
+See [DAMP Performance tests](performance-tests-damp.md) for more details on how to run DAMP, analyze results or add new tests.
+
+## debugger-metrics
+
+debugger-metrics measures the number of modules and the overall size of modules loaded when opening the Debugger in DevTools. This test is a mochitest which can be executed locally with:
+
+```bash
+./mach test devtools/client/framework/test/metrics/browser_metrics_debugger.js --headless
+```
+
+At the end of the test, logs should contain a `PERFHERDER_DATA` entry containing 4 measures. `debugger-modules` is the number of debugger-specific modules loaded, `debugger-chars` is the number of characters in said modules. `all-modules` is the number of modules loaded including shared modules, `all-chars` is the number of characters in said modules.
+
+A significant regression or improvement to this test can indicate that modules are no longer lazy loaded, or a new part of the UI is now loaded upfront.
+
+## inspector-metrics
+
+See the description for debugger-metrics. This test is exactly the same but applied to the inspector panel. It can be executed locally with:
+
+```bash
+./mach test devtools/client/framework/test/metrics/browser_metrics_inspector.js --headless
+```
+
+## netmonitor-metrics
+
+See the description for debugger-metrics. This test is exactly the same but applied to the netmonitor panel. It can be executed locally with:
+
+```bash
+./mach test devtools/client/framework/test/metrics/browser_metrics_netmonitor.js --headless
+```
+
+## webconsole-metrics
+
+See the description for debugger-metrics. This test is exactly the same but applied to the webconsole panel. It can be executed locally with:
+
+```bash
+./mach test devtools/client/framework/test/metrics/browser_metrics_webconsole.js --headless
+```
+
+## server.pool
+
+server.pool measures the performance of the DevTools `Pool` [class](https://searchfox.org/mozilla-central/source/devtools/shared/protocol/Pool.js) which is intensively used by the DevTools server. This test is a mochitest which can be executed with:
+
+```bash
+./mach test devtools/client/framework/test/metrics/browser_metrics_pool.js --headless
+```
+
+At the end of the test, logs should contain a `PERFHERDER_DATA` entry which contain values corresponding to various APIs of the `Pool` class.
+
+A regression or improvement in this test is most likely linked to a change in a file from devtools/shared/protocol.
+
+## toolbox:parent-process
+
+toolbox:parent-process measures the number of objects allocated by DevTools after opening and closing a DevTools toolbox. This test is a mochitest which can be executed with:
+
+```bash
+./mach test devtools/client/framework/test/allocations/browser_allocations_toolbox.js --headless
+```
+
+The test will record allocations while opening and closing the Toolbox several times. The `PERFHERDER_DATA` entry in the logs will contain 3 measures. objects-with-stacks is the number of allocated objects for which the allocation site is known and should be easy to fix for developers. objects-with-no-stacks is for objects for which there is no stack. memory attempts to record the memory, but the results are very noisy. You can refer to devtools/client/framework/test/allocations/README.md for a more detailed description of this test and how to use it to investigate and fix memory issues.
+
+A regression here may indicate a leak, for instance a module which no longer cleans its dependencies. It can also indicate that DevTools is loading more singletons or other objects which are not tied to the lifecycle of the DevTools objects.
+
+## target:parent-process
+
+target:parent-process measures the number of objects created by DevTools to create a tab target. It does not involve DevTools frontend. This test is a mochitest which can be executed with:
+
+```bash
+./mach test devtools/client/framework/test/allocations/browser_allocations_target.js --headless
+```
+
+See the description for toolbox:parent-process for more information.
+
+## reload:parent-process
+
+target:parent-process measures the number of objects created by DevTools when reloading a page inspected by a DevTools Toolbox. This test is a mochitest which can be executed with:
+
+```bash
+./mach test devtools/client/framework/test/allocations/browser_allocations_reload.js --headless
+```
+
+See the description for toolbox:parent-process for more information. Note that this test also records another suite, reload:content-process.
+
+## reload:content-process
+
+See the description for reload:parent-process.
+
+## browser-console:parent-process
+
+browser-console:parent-process measures the number of objects created by DevTools when opening and closing the Browser Console. This test is a mochitest which can be executed with:
+
+```bash
+./mach test devtools/client/framework/test/allocations/browser_allocations_browser_console.js --headless
+```
+
+See the description for toolbox:parent-process for more information.