CINXE.COM
about:debugging — Firefox Source Docs documentation
<!doctype html> <html class="writer-html5" lang="en" data-content_root="../../"> <head> <base href="https://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html"> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>about:debugging — Firefox Source Docs documentation</title> <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50"> <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=19f00094"> <link rel="stylesheet" type="text/css" href="../../_static/graphviz.css?v=fd3f3429"> <link rel="stylesheet" type="text/css" href="../../_static/copybutton.css?v=76b2166b"> <link rel="stylesheet" type="text/css" href="../../_static/custom_theme.css?v=a7d3e023"> <link rel="stylesheet" type="text/css" href="../../_static/design-style.1e8bd061cd6da7fc9cf755528e8ffc24.min.css?v=0a3b3ea7"> <link rel="shortcut icon" href="../../_static/firefox.ico"><!--[if lt IE 9]> <script src="../../_static/js/html5shiv.min.js"></script> <![endif]--> <script src="../../_static/jquery.js?v=5d32c60e"></script> <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script> <script src="../../_static/documentation_options.js?v=5929fcd5"></script> <script src="../../_static/doctools.js?v=9a2dae69"></script> <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script> <script src="../../_static/clipboard.min.js?v=a7894cd8"></script> <script src="../../_static/copybutton.js?v=30646c52"></script> <script src="../../_static/design-tabs.js?v=36754332"></script> <script src="../../_static/js/theme.js"></script> <link rel="index" title="Index" href="../../genindex.html"> <link rel="search" title="Search" href="../../search.html"> <meta http-equiv="X-Translated-By" content="Google"> <meta http-equiv="X-Translated-To" content="iw"> <script type="text/javascript" src="https://www.gstatic.com/_/translate_http/_/js/k=translate_http.tr.en_GB.omlEigW4xY8.O/am=DgY/d=1/rs=AN8SPfpjsL9kUWY0h-sp7Ilu7hZWGwEmeg/m=corsproxy" data-sourceurl="https://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html"></script> <link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200" rel="stylesheet"> <script type="text/javascript" src="https://www.gstatic.com/_/translate_http/_/js/k=translate_http.tr.en_GB.omlEigW4xY8.O/am=DgY/d=1/exm=corsproxy/ed=1/rs=AN8SPfpjsL9kUWY0h-sp7Ilu7hZWGwEmeg/m=phishing_protection" data-phishing-protection-enabled="false" data-forms-warning-enabled="true" data-source-url="https://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html"></script> <meta name="robots" content="none"> </head> <body class="wy-body-for-nav"> <script type="text/javascript" src="https://www.gstatic.com/_/translate_http/_/js/k=translate_http.tr.en_GB.omlEigW4xY8.O/am=DgY/d=1/exm=corsproxy,phishing_protection/ed=1/rs=AN8SPfpjsL9kUWY0h-sp7Ilu7hZWGwEmeg/m=navigationui" data-environment="prod" data-proxy-url="https://firefox--source--docs-mozilla-org.translate.goog" data-proxy-full-url="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB" data-source-url="https://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html" data-source-language="pl" data-target-language="iw" data-display-language="en-GB" data-detected-source-language="" data-is-source-untranslated="false" data-source-untranslated-url="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html&anno=2" data-client="tr"></script> <div class="wy-grid-for-nav"> <nav data-toggle="wy-nav-shift" class="wy-nav-side"> <div class="wy-side-scroll"> <div class="wy-side-nav-search"><a href="https://firefox--source--docs-mozilla-org.translate.goog/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB" class="icon icon-home"> Firefox Source Docs <img src="../../_static/firefox-wordmark.svg" class="logo" alt="Logo"> </a><!-- -- This code is governed by the BSD license ----> <div> <h3>Quick search</h3> <script> (function () { var cx = "dd12886298f75dbef"; var gcse = document.createElement("script"); gcse.async = true; gcse.src = "https://cse.google.com/cse.js?cx=" + cx; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(gcse, s); })(); </script><gcse:search></gcse:search> </div> </div> <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu"> <p class="caption" role="heading"><span class="caption-text">Overview</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/glossary/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">A Glossary of Common Terms</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/overview/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">A Quick Guide to Mozilla Applications</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Getting Started</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/setup/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Getting Set Up To Work On The Firefox Codebase</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Working On Firefox</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/contributing/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Working on Firefox</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/bug-mgmt/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Bug Handling</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Firefox User Guide</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox DevTools User Docs</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Source Code Documentation</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mots/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Governance</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/browser/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox Front-end</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/dom/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">DOM</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/editor/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Editor</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/layout/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Style system (CSS) & Layout</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/gfx/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Graphics</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/ipc/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Processes, Threads and IPC</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox DevTools Contributor Docs</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/toolkit/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Toolkit</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/js/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">SpiderMonkey</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mobile/android/geckoview/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">GeckoView</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mobile/android/fenix/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Fenix</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mobile/android/focus-android/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Focus for Android</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/dom/bindings/webidl/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">WebIDL</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/modules/libpref/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">libpref</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/networking/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Networking</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/remote/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Remote Protocols</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/services/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Services</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/uriloader/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">File Handling</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/widget/cocoa/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox on macOS</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/widget/windows/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox on Windows</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/toolkit/components/ml/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox AI Platform</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/accessible/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Accessibility</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/code-quality/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Code quality</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/writing-rust-code/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Writing Rust Code</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/rust-components/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Rust Components</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/tools/profiler/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Gecko Profiler</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/performance/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Performance</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/storage/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Database bindings (SQLite, KV, …)</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/xpcom/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">XPCOM</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/nspr/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">NSPR</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/security/nss/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Network Security Services (NSS)</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/content-security/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Web Security Checks in Gecko</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">The Firefox Build System</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mach/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Mach</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/tools/try/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Pushing to Try</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/build/buildsystem/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Build System</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/taskcluster/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox CI and Taskgraph</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/tools/moztreedocs/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Managing Documentation</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mozbuild/vendor/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Vendoring Third Party Components</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Testing & Test Infrastructure</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/automated-testing/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Automated Testing</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/treeherder-try/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Understanding Treeherder Results</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/sheriffed-intermittents/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Sheriffed intermittent failures</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/tests-for-new-config/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Turning on Firefox tests for a new configuration</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/intermittent/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Avoiding intermittent tests</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/testing-policy/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Testing Policy</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/ci-configs/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Configuration Changes</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/browser-chrome/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Browser chrome mochitests</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/chrome-tests/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Chrome Tests</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/marionette/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Marionette</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/geckodriver/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">geckodriver</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/test-verification/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Test Verification</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/webrender/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">WebRender Tests</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/mochitest-plain/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Mochitest</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/xpcshell/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">XPCShell tests</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/tps/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">TPS</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/web-platform/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">web-platform-tests</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/gtest/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">GTest</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/tools/fuzzing/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Fuzzing</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/tools/sanitizer/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Sanitizer</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing/perfdocs/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Performance Testing</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/tools/code-coverage/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Code coverage</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/testing-rust-code/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Testing & Debugging Rust Code</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Releases & Updates</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/update-infrastructure/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Mozilla Update Infrastructure</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/update-infrastructure/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#watershed-updates">Watershed Updates</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/update-infrastructure/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#desupport-updates">Desupport Updates</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Localization & Internationalization</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/intl/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Internationalization</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/l10n/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Localization</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Firefox and Python</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/mozbase/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">mozbase</a></li> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/python/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Using third-party Python packages</a></li> </ul> <p class="caption" role="heading"><span class="caption-text">Metrics Collected in Firefox</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/metrics/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Metrics</a></li> </ul> </div> </div> </nav> <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> <nav class="wy-nav-top" aria-label="Mobile navigation menu"><i data-toggle="wy-nav-top" class="fa fa-bars"></i> <a href="https://firefox--source--docs-mozilla-org.translate.goog/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">Firefox Source Docs</a> </nav> <div class="wy-nav-content"> <div class="rst-content"><!-- This Source Code Form is subject to the terms of the Mozilla Public - License, v. 2.0. If a copy of the MPL was not distributed with this file, - You can obtain one at http://mozilla.org/MPL/2.0/. --> <div role="navigation" aria-label="Page navigation"> <ul class="wy-breadcrumbs"> <li><a href="https://firefox--source--docs-mozilla-org.translate.goog/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB" class="icon icon-home" aria-label="Home"></a></li> <li class="breadcrumb-item active">about:debugging</li> <li class="wy-breadcrumbs-aside"><a href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://bugzilla.mozilla.org/enter_bug.cgi?product%3DDeveloper%2BInfrastructure%26component%3DFirefox%2BSource%2BDocs%253A%2BContent%26short_desc%3DDocumentation%2Bissue%2Bon%2Bdevtools-user/about_colon_debugging/index%26comment%3DURL%2B%3D%2Bhttps://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html%26bug_file_loc%3Dhttps://firefox-source-docs.mozilla.org/devtools-user/about_colon_debugging/index.html" rel="nofollow">Report an issue</a> / <a href="https://firefox--source--docs-mozilla-org.translate.goog/_sources/devtools-user/about_colon_debugging/index.rst.txt?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB" rel="nofollow"> View page source</a></li> </ul> <hr> </div> <div role="main" class="document" itemscope itemtype="http://schema.org/Article"> <div itemprop="articleBody"> <section id="about-debugging"> <h1><a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a><a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#about-debugging" title="Link to this heading">¶</a></h1> <p>The <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code> page provides a single place from which you can attach the Firefox Developer Tools to a number of debugging targets. At the moment it supports three main sorts of targets: restartless add-ons, tabs, and workers.</p> <p>This is also the main entry point to remotely debug Firefox, in particular Firefox for Android.</p> <section id="opening-the-about-debugging-page"> <h2>Opening the <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> page<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#opening-the-about-debugging-page" title="Link to this heading">¶</a></h2> <p>There are two ways to open <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code>:</p> <ul class="simple"> <li><p>Type <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code> in the Firefox URL bar.</p></li> <li><p>In the <strong>Tools</strong> > <strong>Browser Tools</strong> menu, click <strong>Remote Debugging</strong>.</p></li> </ul> <p>When <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> opens, on the left-hand side, you’ll see a sidebar with two options and information about your remote debugging setup:</p> <dl class="simple"> <dt> Setup </dt> <dd> <p>Use the Setup tab to configure the connection to your remote device.</p> </dd> <dt> This Firefox </dt> <dd> <p>Provides information about temporary extensions you have loaded for debugging, extensions that are installed in Firefox, the tabs that you currently have open, and service workers running on Firefox.</p> </dd> </dl><img alt="../../_images/about_debugging_setup.png" class="border" src="../../_images/about_debugging_setup.png"> <p>If your <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code> page is different from the one displayed here, go to <code class="docutils literal notranslate"><span class="pre">about:config</span></code>, find and set the option <code class="docutils literal notranslate"><span class="pre">devtools.aboutdebugging.new-enabled</span></code> to <strong>true</strong>.</p> </section> <section id="setup-tab"> <h2>Setup tab<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#setup-tab" title="Link to this heading">¶</a></h2> <section id="connecting-to-a-remote-device"><span id="about-colon-debugging-connecting-to-a-remote-device"></span> <h3>Connecting to a remote device<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#connecting-to-a-remote-device" title="Link to this heading">¶</a></h3> <p>Firefox supports debugging over USB with Android devices, using the <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> page.</p> <p>Before you connect:</p> <ol class="arabic simple" start="0"> <li><p>Ensure clicking once on “Enable USB Devices” in <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> homepage.</p></li> </ol><img alt="../../_images/about_debugging_home.png" class="border" src="../../_images/about_debugging_home.png"> <ol class="arabic simple"> <li><p>Enable Developer settings on your Android device. Press 7 times on “Build Number” from your “About your phone” in the device settings app.</p></li> <li><p>Enable “USB debugging” in the Android Developer settings. <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.android.com/studio/debug/dev-options">Detailed guide for 1. and 2.</a></p></li> </ol><img alt="../../_images/android_usb_debugging.png" class="border" src="../../_images/android_usb_debugging.png"> <ol class="arabic simple" start="3"> <li><p>Enable <strong>Remote Debugging via USB</strong> in the Advanced Settings in Firefox on the Android device.</p></li> </ol><img alt="../../_images/android_firefox_debugging_option.png" class="border" src="../../_images/android_firefox_debugging_option.png"> <ol class="arabic simple" start="4"> <li><p>Connect the Android device to your computer using a USB cable. If a USB cable is not available, <a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#about-colon-debugging-connecting-to-android-over-wi-fi"><span class="std std-ref">connect to Android over Wi-Fi</span></a>.</p></li> </ol> <p>If your device doesn’t appear in the lefthand side of the <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> page, try clicking the <strong>Refresh devices</strong> button.</p> <p><strong>If it still doesn’t appear</strong>, it may be because the link between your Android device and your computer is not authorized yet. First make sure you have installed <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.android.com/studio/command-line/adb.html">Android Debug Bridge</a> from Android Tools on your computer in order for it to be able to connect to your device. Next, disable every debugging setting already activated and repeat the steps described before. Your device should show a popup to authorize your computer to connect to it — accept this and then click the <strong>Refresh devices</strong> button again. The device should appear.</p> <div class="admonition note"> <p class="admonition-title">Note</p> <p>You do not need to install the full Android Studio SDK. Only adb is needed.</p> </div> <p>To start a debugging session, first open the page that you wish to debug and then click <strong>Connect</strong> next to the device name to open a connection to it. If the connection was successful, you can now click the name of the device to switch to a tab with information about the device.</p><img alt="Screenshot of the debugging page for an Android device" class="border" src="../../_images/device_information.png"> <p>The information on this page is the same as the information on the <strong>This Firefox</strong> tab, but instead of displaying information for your computer, it displays the information for the remote device with the addition of a <strong>Tabs</strong> section with an entry for each of the tabs open on the remote device.</p> <p>Note: If the version of Firefox on your remote device is more than one major version older than the version running on your computer, you may see a message like the following:</p><img alt="The connected browser has an old version (68.2.0). The minimum supported version (69.0a1). This is an unsupported setup and may cause DevTools to fail. Please update the connected browser." class="center" src="../../_images/version_warning.png"> <p>In Firefox 76 and above, the message can look like the following:</p><img alt="This version of Firefox cannot debug Firefox for Android (68). We recommend installing Firefox for Android Nightly on your phone for testing. More details" class="center" src="../../_images/fxand-68-error.png"> <p>See Connection for Firefox for Android 68 for more information.</p> <p>In the image above, there are three tabs open: <strong>Network or cache Recipe</strong>, <strong>Nightly Home</strong>, and <strong>About Nightly</strong>. To debug the contents of one of these tabs, click the <strong>Inspect</strong> button next to its title. When you do, the Developer Tools open in a new tab.</p><img alt="Screenshot showing the remote debugging window, with the editable URL bar" class="border" src="../../_images/remote-debugger-w-url-buttons.png"> <p>Above the usual list of tools, you can see information about the device you are connected to, including the fact that you are connected (in this example) via USB, to Firefox Preview, on a Pixel 2, as well as the title of the page that you are debugging, and the address of the page.</p> <p>Starting in Firefox 78, the URL bar is editable, so that you can change the URL used by the browser on the remote device, by typing in Firefox for Desktop. You can also reload the page by clicking the <strong>Reload</strong> button next to the URL bar, and (starting 79), navigate backward or forward in the browsing history with the <strong>Back</strong> and <strong>Forward</strong> buttons.</p> </section> <section id="connecting-to-android-over-wi-fi"><span id="about-colon-debugging-connecting-to-android-over-wi-fi"></span> <h3>Connecting to Android over Wi-Fi<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#connecting-to-android-over-wi-fi" title="Link to this heading">¶</a></h3> <p>Firefox can debug Firefox for Android through <cite>adb</cite> and the <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.android.com/tools/adb%23connect-to-a-device-over-wi-fi">“Wireless debugging” feature</a> of Android 11+, without requiring any USB cable.</p> <p>Prerequisites:</p> <ul class="simple"> <li><p>Device must run Android 11 or later.</p></li> <li><p>The <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.android.com/tools/adb">adb</a> program is available. You do not need Android Studio nor the full Android SDK.</p></li> <li><p>The Android device and the computer with <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code> are in the same network.</p></li> </ul> <p>Steps to connect wirelessly with the Android device:</p> <ol class="arabic simple"> <li><p>Determine the IP address of your Android device on your local network. For example by locating the Internet/Wi-Fi setting and viewing details of the current (Wi-Fi) network.</p></li> <li><p><a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.android.com/studio/debug/dev-options%23enable">Enable Developer options</a> on your Android device.</p></li> <li><p>Enable Wireless debugging by tapping on the toggle at the “Wireless debugging” bar at the Developer options, then tap on the “Wireless debugging” bar (before the toggle) to open the “Wireless debugging” screen.</p> <ol class="arabic simple"> <li><p>An alternative to the previous step is to open “Quick settings developer tiles” at Developer options, and enabling the “Wireless debugging” tile. After this, you can long-press the “Wireless debugging” tile from the Quick Settings panel to launch the “Wireless debugging” screen.</p></li> </ol></li> <li><p>Tap on “Pair device with pairing code” in the “Wireless debugging” screen. This displays a six-digit code and an IP address and port. The port is unique to the pairing setup.</p></li> <li><p>From the terminal, run <code class="docutils literal notranslate"><span class="pre">adb</span> <span class="pre">pair</span> <span class="pre">[ip</span> <span class="pre">address</span> <span class="pre">from</span> <span class="pre">step</span> <span class="pre">1]:[port</span> <span class="pre">from</span> <span class="pre">step</span> <span class="pre">4]</span></code> and enter the six-digit code from step 4.</p></li> <li><p>To finally connect wirelessly, look up the (random) port at the “IP address & Port” section of the “Wireless debugging” screen. The port is distinct from step 4. Run <code class="docutils literal notranslate"><span class="pre">adb</span> <span class="pre">connect</span> <span class="pre">[ip</span> <span class="pre">address</span> <span class="pre">from</span> <span class="pre">step</span> <span class="pre">1]:[port</span> <span class="pre">from</span> <span class="pre">step</span> <span class="pre">6]</span></code> to connect.</p></li> </ol> <p>Now, the adb server on your computer is connected with the adb daemon on the Android device. All Firefox apps with the “Remote Debugging via USB” setting enabled will now appear in <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code>.</p> <p>If you do not see any Firefox for Android debugging target:</p> <ul class="simple"> <li><p>Confirm that adb is connected by running <code class="docutils literal notranslate"><span class="pre">adb</span> <span class="pre">devices</span></code>.</p></li> <li><p>Confirm that the Firefox app is running and that the “Remote Debugging via USB” setting is checked.</p></li> </ul> </section> <section id="connecting-over-the-network"> <h3>Connecting over the Network<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#connecting-over-the-network" title="Link to this heading">¶</a></h3> <div class="admonition note"> <p class="admonition-title">Note</p> <p>The steps below do not work for Android. Follow the instructions at <a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#about-colon-debugging-connecting-to-android-over-wi-fi"><span class="std std-ref">Connecting to Android over Wi-Fi</span></a> instead.</p> </div> <p>You can connect to a Firefox Debug server on your network, or on your debugging machine using the <strong>Network Location</strong> settings of the <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> page.</p><img alt="../../_images/network_location.png" class="center" src="../../_images/network_location.png"> <p>Enter the location and port on which the debugger server is running. When you do, it is added to the Network locations list along with the devices, as shown below:</p><img alt="../../_images/connect_network_location.png" class="center" src="../../_images/connect_network_location.png"> </section> </section> <section id="this-firefox"> <h2>This Firefox<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#this-firefox" title="Link to this heading">¶</a></h2> <p>The <strong>This Firefox</strong> tab combines the features of Extensions, Tabs, and Workers into a single tab with the following sections:</p> <dl class="simple"> <dt> Temporary Extensions </dt> <dd> <p>Displays a list of the extensions that you have loaded using the <strong>Load Temporary Add-on</strong> button.</p> </dd> <dt> Extensions </dt> <dd> <p>This section lists information about the extensions that you have installed on your system.</p> </dd> <dt> Service Workers, Shared Workers, and Other Workers </dt> <dd> <p>There are three sections on this page that deal with Service Workers, Shared Workers, and Other Workers.</p> </dd> </dl><img alt="../../_images/about_debugging_this_firefox.png" class="border" src="../../_images/about_debugging_this_firefox.png"> <p>Whether internal extensions appear in the list on this page depends on the setting of the <code class="docutils literal notranslate"><span class="pre">devtools.aboutdebugging.showHiddenAddons</span></code> preference. If you need to see these extensions, navigate to <code class="docutils literal notranslate"><span class="pre">about:config</span></code> and make sure that the preference is set to <code class="docutils literal notranslate"><span class="pre">true</span></code>.</p> </section> <section id="extensions"> <h2>Extensions<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#extensions" title="Link to this heading">¶</a></h2> <section id="loading-a-temporary-extension"> <h3>Loading a temporary extension<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#loading-a-temporary-extension" title="Link to this heading">¶</a></h3> <p>With the <strong>Load Temporary Add-on</strong> button you can temporarily load a WebExtension from a directory on disk. Click the button, navigate to the directory containing the add-on and select its manifest file. The temporary extension is then displayed under the <strong>Temporary Extensions</strong> header.</p> <p>You don’t have to package or sign the extension before loading it, and it stays installed until you restart Firefox.</p> <p>The major advantages of this method, compared with installing an add-on from an XPI, are:</p> <ul class="simple"> <li><p>You don’t have to rebuild an XPI and reinstall when you change the add-on’s code;</p></li> <li><p>You can load an add-on without signing it and without needing to disable signing.</p></li> </ul> <p>Once you have loaded a temporary extension, you can see information about it and perform operations on it.</p><img alt="Screenshot of the debugging information panel for a temporary extension" class="center" src="../../_images/temporary_extension.png"> <p>You can use the following buttons:</p> <dl class="simple"> <dt> Inspect </dt> <dd> <p>Loads the extension in the debugger.</p> </dd> <dt> Reload </dt> <dd> <p>Reloads the temporary extension. This is handy when you have made changes to the extension.</p> </dd> <dt> Remove </dt> <dd> <p>Unloads the temporary extension.</p> </dd> </dl> <p>Other information about the extension is displayed:</p> <dl class="simple"> <dt> Location </dt> <dd> <p>The location of the extension’s source code on your local system.</p> </dd> <dt> Extension ID </dt> <dd> <p>The temporary ID assigned to the extension.</p> </dd> <dt> Internal UUID </dt> <dd> <p>The internal UUID assigned to the extension.</p> </dd> <dt> Manifest URL </dt> <dd> <p>If you click the link, the manifest for this extension is loaded in a new tab.</p> </dd> </dl> </section> <section id="updating-a-temporary-extension"> <h3>Updating a temporary extension<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#updating-a-temporary-extension" title="Link to this heading">¶</a></h3> <p>If you install an extension in this way, what happens when you update the extension?</p> <ul class="simple"> <li><p>If you change files that are loaded on demand, like <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts">content scripts</a> or <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension%23browser_actions_2">popups</a>, then changes you make are picked up automatically, and you’ll see them the next time the content script is loaded or the popup is shown.</p></li> <li><p>For other changes, click the <strong>Reload</strong> button. This does what it says:</p> <ul> <li><p>Reloads any persistent scripts, such as <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension%23background_scripts">background scripts</a></p></li> <li><p>Parses the <code class="docutils literal notranslate"><span class="pre">manifest.json</span></code> file again, so changes to <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissions</a>, <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts">content_scripts</a>, <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action">browser_action</a> or any other keys take effect</p></li> </ul></li> </ul> </section> <section id="installed-extensions"> <h3>Installed Extensions<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#installed-extensions" title="Link to this heading">¶</a></h3> <p>The permanently installed extensions are listed in the next section, <strong>Extensions</strong>. For each one, you see something like the following:</p><img alt="Screenshot of the debugging information panel for an installed extension" class="center" src="../../_images/installed_extension.png"> <p>The <strong>Inspect</strong> button, and the <strong>Extension ID</strong> and <strong>Internal UUID</strong> fields are the same as for temporary extensions.</p> <p>Just as it does with temporarily loaded extensions, the link next to <strong>Manifest URL</strong> opens the loaded manifest in a new tab.</p> <div class="admonition note"> <p class="admonition-title">Note</p> <p>It’s recommended that you use the Browser Toolbox, not the Add-on Debugger, for debugging WebExtensions. See <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://extensionworkshop.com/documentation/develop/debugging/">Debugging WebExtensions</a> for all the details.</p> </div> <p>The Add-ons section in <a class="reference external" href="about:debugging?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB">about:debugging</a> lists all WebExtensions that are currently installed. Next to each entry is a button labeled <strong>Inspect</strong>.</p> <div class="admonition note"> <p class="admonition-title">Note</p> <p>This list may include add-ons that came preinstalled with Firefox.</p> </div> <p>If you click <strong>Inspect</strong>, the Add-on Debugger will start in a new tab.</p><iframe width="560" height="315" src="https://www.youtube.com/embed/efCpDNuNg_c" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> <br><br> </section> </section> <section id="workers"> <h2>Workers<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#workers" title="Link to this heading">¶</a></h2> <p>The Workers section shows all the workers you’ve got registered on your Firefox, categorized as follows:</p> <ul class="simple"> <li><p>All registered <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API">Service Workers</a></p></li> <li><p>All registered <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Web/API/SharedWorker">Shared Workers</a></p></li> <li><p>Other workers, including Chrome Workers and <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers%23dedicated_workers">Dedicated Workers</a></p></li> </ul> <p>You can connect the developer tools to each worker, and send push notifications to service workers.</p><img alt="../../_images/about_debugging_workers.png" class="border" src="../../_images/about_debugging_workers.png"> <section id="service-worker-state"> <h3>Service worker state<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#service-worker-state" title="Link to this heading">¶</a></h3> <p>The list of service workers shows the state of the service worker in its <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developers.google.com/web/fundamentals/primers/service-workers/lifecycle">lifecycle</a>. Three states are possible:</p> <ul class="simple"> <li><p><em>Registering</em>: this covers all states between the service worker’s initial registration, and its assuming control of pages. That is, it subsumes the <em>installing</em>, <em>activating</em>, and <em>waiting</em> states.</p></li> <li><p><em>Running</em>: the service worker is currently running. It’s installed and activated, and is currently handling events.</p></li> <li><p><em>Stopped</em>: the service worker is installed and activated, but has been terminated after being idle.</p></li> </ul><img alt="Screenshot of the debugging panel for a service worker that is in the Running state" class="center" src="../../_images/sample_service_worker.png"> <p>This section uses a simple ServiceWorker demo, hosted at <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://serviceworke.rs/push-simple/">https://serviceworke.rs/push-simple/</a>.</p> <div class="admonition note"> <p class="admonition-title">Note</p> <p>From Firefox 79 onwards, you can access similar information on the Service Workers registered on a particular domain by going to the Firefox DevTools <a class="reference internal" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/application/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB"><span class="doc">Application panel</span></a>.</p> </div> </section> <section id="unregistering-service-workers"> <h3>Unregistering service workers<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#unregistering-service-workers" title="Link to this heading">¶</a></h3> <p>Click the <strong>Unregister</strong> button to unregister the service worker.</p> </section> <section id="sending-push-events-to-service-workers"> <h3>Sending push events to service workers<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#sending-push-events-to-service-workers" title="Link to this heading">¶</a></h3> <p>To debug push notifications, you can set a breakpoint in the <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://developer.mozilla.org/en-US/docs/Web/API/PushEvent">push event</a> listener. However, you can also debug push notifications locally, without needing the server. Click the <strong>Push</strong> button to send a push event to the service worker.</p> </section> <section id="service-workers-not-compatible"> <h3>Service workers not compatible<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#service-workers-not-compatible" title="Link to this heading">¶</a></h3> <p>A warning message is displayed at the top of the <strong>This Firefox</strong> tab if service workers are incompatible with the current browser configuration, and therefore cannot be used or debugged.</p><img alt="../../_images/worker_warning.png" class="center" src="../../_images/worker_warning.png"> <p>Service workers can be unavailable if:</p> <ul class="simple"> <li><p><code class="docutils literal notranslate"><span class="pre">dom.serviceWorkers.enable</span></code> preference is set to false in <code class="docutils literal notranslate"><span class="pre">about:config</span></code>.</p></li> <li><p><code class="docutils literal notranslate"><span class="pre">browser.privatebrowsing.autostart</span></code> preference is set to true in <code class="docutils literal notranslate"><span class="pre">about:config</span></code> or through Firefox preferences UI.</p></li> </ul> <p>The <code class="docutils literal notranslate"><span class="pre">browser.privatebrowsing.autostart</span></code> preference is set to true if the user selects <strong>Never remember history</strong> option or enables <strong>Always use private browsing mode</strong> in preferences UI, see <a class="reference external" href="about:preferences?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#privacy">about:preferences#privacy</a></p> <p>Always use private browsing mode:</p><img alt="../../_images/always_use_private_browsing_mode.png" class="center" src="../../_images/always_use_private_browsing_mode.png"> <p>Never remember history:</p><img alt="../../_images/never_remember_history.png" class="center" src="../../_images/never_remember_history.png"> </section> </section> <section id="connection-to-firefox-for-android-68"> <h2>Connection to Firefox for Android 68<a class="headerlink" href="https://firefox--source--docs-mozilla-org.translate.goog/devtools-user/about_colon_debugging/index.html?_x_tr_sl=pl&_x_tr_tl=iw&_x_tr_hl=en-GB#connection-to-firefox-for-android-68" title="Link to this heading">¶</a></h2> <p>Releases of Firefox for Android that are based on version 68 cannot be debugged from desktop Firefox versions 69 or later, because of the difference in release versions. Until such time as Firefox for Android is updated to a newer major release, in synch with desktop Firefox, you should use one of the following Firefox for Android versions:</p> <ul class="simple"> <li><p><a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://play.google.com/store/apps/details?id%3Dorg.mozilla.fenix">Firefox Preview</a>, if your desktop Firefox is the main release or Developer Edition</p></li> <li><p><a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://play.google.com/store/apps/details?id%3Dorg.mozilla.fenix">Firefox for Android Nightly</a></p></li> </ul> <p>If you prefer to test with the main release of Firefox for Android (i.e., based on release 68), you can do so with the desktop <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://support.mozilla.org/en-US/kb/switch-to-firefox-extended-support-release-esr">Firefox Extended Support Release (ESR)</a>, which is also based on version 68.</p> <p>Note that <code class="docutils literal notranslate"><span class="pre">about:debugging</span></code> is not enabled by default in Firefox ESR. To enable it, open the <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://support.mozilla.org/en-US/kb/about-config-editor-firefox">Configuration Editor</a> (<code class="docutils literal notranslate"><span class="pre">about:config</span></code>) and set <code class="docutils literal notranslate"><span class="pre">devtools.aboutdebugging.new-enabled</span></code> to <strong>true</strong>.</p> <p>If you used a higher version of Firefox prior to installing Firefox ESR, you will be prompted to create a new user profile, in order to protect your user data. For more information, see <a class="reference external" href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://support.mozilla.org/en-US/kb/dedicated-profiles-firefox-installation%23w_what-happens-to-my-profile-if-i-downgrade-to-a-previous-version-of-firefox">What happens to my profile if I downgrade to a previous version of Firefox?</a></p> </section> </section> </div> </div> <footer> <hr> <div role="contentinfo"> <p></p> </div> Built with <a href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://www.sphinx-doc.org/">Sphinx</a> using a <a href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://translate.google.com/website?sl=pl&tl=iw&hl=en-GB&u=https://readthedocs.org">Read the Docs</a>. </footer> </div> </div> </section> </div> <script> jQuery(function () { SphinxRtdTheme.Navigation.enable(true); }); </script> <script>function gtElInit() {var lib = new google.translate.TranslateService();lib.translatePage('pl', 'iw', function () {});}</script> <script src="https://translate.google.com/translate_a/element.js?cb=gtElInit&hl=en-GB&client=wt" type="text/javascript"></script> </body> </html>