firefox-devtools · canova · Dec 18, 2025 · Nov 6, 2025 · Nov 6, 2025 · Nov 13, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -9,7 +9,10 @@ on:
 
 jobs:
   lint:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -21,7 +24,10 @@ jobs:
         run: yarn lint
 
   tests:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -35,12 +41,16 @@ jobs:
         run: yarn test --coverage --logHeapUsage -w=4 --workerIdleMemoryLimit=1.5G
 
       - name: Upload coverage to Codecov
+        if: matrix.os == 'ubuntu-latest'
         uses: codecov/codecov-action@v5
         with:
           fail_ci_if_error: false
 
   build-prod:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -55,7 +65,10 @@ jobs:
         run: yarn build-symbolicator-cli:quiet
 
   licence-check:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -67,7 +80,10 @@ jobs:
         run: yarn license-check
 
   typecheck:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -79,7 +95,10 @@ jobs:
         run: yarn ts
 
   alex:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
@@ -91,7 +110,10 @@ jobs:
         run: yarn test-alex
 
   yarn-lock:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
     steps:
       - name: Checkout code
         uses: actions/checkout@v5

diff --git a/.prettierrc.js b/.prettierrc.js
@@ -1,27 +1,4 @@
 module.exports = {
   singleQuote: true,
   trailingComma: 'es5',
-  overrides: [
-    {
-      files: 'src/utils/path.js',
-      options: {
-        // New versions of Prettier rewrite Flow comments to non-comments, but
-        // this is a problem in this file because it contains a Flow comment
-        // that's not parsed properly by Babel.
-        // This file uses Flow in a way that's Typescript compatible, so we can
-        // use a typescript parser. This typescript parser doesn't rewrite
-        // comments, so it works in this case.
-        parser: 'babel-ts',
-      },
-    },
-    {
-      files: 'bin/*.js',
-      options: {
-        // Files in bin/ are javascript files that may use Flow comments. We
-        // don't want the content of these Flow comments to be output outside of
-        // comments so that the file can still be run directly with node.
-        parser: 'espree',
-      },
-    },
-  ],
 };
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -8,7 +8,7 @@
       "runtimeExecutable": "yarn",
       "runtimeArgs": ["test"],
       "program": "${workspaceFolder}/node_modules/jest/bin/jest",
-      "args": ["--runInBand", "${file}"],
+      "args": ["--runInBand", "--testTimeout=300000", "${file}"],
       "cwd": "${workspaceFolder}",
       "internalConsoleOptions": "openOnSessionStart",
       "request": "launch",

diff --git a/appveyor.yml b/appveyor.yml
diff --git a/bin/l10n-sync.js b/bin/l10n-sync.js
@@ -13,7 +13,7 @@ const readline = require('readline');
 const { promisify } = require('util');
 
 /**
- * @typeef {Object} ExecFilePromiseResult
+ * @typedef {Object} ExecFilePromiseResult
  * @property {string | Buffer} stdout
  * @property {string | Buffer} stderr
  */

diff --git a/bin/pre-install.js b/bin/pre-install.js
@@ -2,7 +2,9 @@
  * 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/. */
 
-/*:: type AgentsVersion = { [agentName: string]: string }; */
+/**
+ * @typedef {Object.<string, string>} AgentsVersion
+ */
 
 /*
  * This file is run when a user runs `yarn install`, before doing anything else.
@@ -21,13 +23,12 @@ function checkVersions() {
     return;
   }
 
-  const agents /*: AgentsVersion */ = userAgent
-    .split(' ')
-    .reduce((agents, agent) => {
-      const [key, value] = agent.split('/');
-      agents[key] = value;
-      return agents;
-    }, {});
+  /** @type {AgentsVersion} */
+  const agents = userAgent.split(' ').reduce((agents, agent) => {
+    const [key, value] = agent.split('/');
+    agents[key] = value;
+    return agents;
+  }, {});
 
   const checks = [checkNode(agents), checkYarn(agents)];
 
@@ -47,7 +48,10 @@ function versionCompare(a, b) {
   return a.localeCompare(b, undefined, { numeric: true });
 }
 
-function checkNode(agents /*: AgentsVersion */) {
+/**
+ * @param {AgentsVersion} agents
+ */
+function checkNode(agents) {
   // Node versions usually have a starting `v`.
   const nodeVersion = agents.node.replace(/^v/, '');
   const expectedNodeVersion = parseExpectedNodeVersion();
@@ -75,7 +79,10 @@ function checkNode(agents /*: AgentsVersion */) {
   return true;
 }
 
-function checkYarn(agents /*: AgentsVersion */) {
+/**
+ * @param {AgentsVersion} agents
+ */
+function checkYarn(agents) {
   if (!('yarn' in agents)) {
     console.error(
       'This project uses Yarn instead of npm, please run `yarn install` instead of `npm install`.\n'

diff --git a/docs-developer/call-tree.md b/docs-developer/call-tree.md
@@ -67,9 +67,9 @@ One key point of the aggregation done in the call tree is that it's focused on w
 
 Imagine this simplified example of 3 samples of mixed C++, JavaScript Code (js), and JIT optimized JavaScript (JIT). The functions are all labeled as to their implementation.
 
-| Sample index | Sample's stack                                                                                 |
-| ------------ | ---------------------------------------------------------------------------------------------- |
-| 0            | `JS::RunScript [c++]  ➡  onLoad [js]  ➡  a [js]  ➡  b [js]`                                 |
+| Sample index | Sample's stack                                                                             |
+| ------------ | ------------------------------------------------------------------------------------------ |
+| 0            | `JS::RunScript [c++]  ➡  onLoad [js]  ➡  a [js]  ➡  b [js]`                                |
 | 1            | `JS::RunScript [c++]  ➡  onLoad [js]  ➡  js::jit::IonCannon [c++]  ➡  a [JIT]  ➡  b [JIT]` |
 | 2            | `JS::RunScript [c++]  ➡  onLoad [js]  ➡  js::jit::IonCannon [c++]  ➡  a [JIT]  ➡  b [JIT]` |
 
@@ -113,8 +113,8 @@ Now, taking the stacks and building a call tree produces the following:
 
 This is the correct tree of what you would want to see. But since we are mixing languages together into the same stack system, it might be nice to view only JS functions. In order to do that we hide any C++ stacks, and assign them to the nearest JS stack. Our tables would be updated to look like the following.
 
-| Sample index | Sample's stack                          |
-| ------------ | --------------------------------------- |
+| Sample index | Sample's stack                        |
+| ------------ | ------------------------------------- |
 | 0            | `onLoad [js]  ➡  a [js]  ➡  b [js]`   |
 | 1            | `onLoad [js]  ➡  a [JIT]  ➡  b [JIT]` |
 | 2            | `onLoad [js]  ➡  a [JIT]  ➡  b [JIT]` |

diff --git a/docs-developer/data-sources.md b/docs-developer/data-sources.md
@@ -16,20 +16,6 @@ Samples don't record every event that happens within the system, so some informa
 
 ### More Documentation on the Gecko Profiler:
 
-- [nsIProfiler.idl](https://dxr.mozilla.org/mozilla-central/source/tools/profiler/gecko/nsIProfiler.idl)
-- [ProfileEntry.h](https://dxr.mozilla.org/mozilla-central/rev/b043233ec04f06768d59dcdfb9e928142280f3cc/tools/profiler/core/ProfileBufferEntry.h#322-411)
-
-- [Profile Data Format](./profile-data)
-
-## Timeline - DocShell Markers (unused in the Firefox Profiler)
-
-The Gecko Profiler records marker data, but it doesn't include all of the markers available in the system. There is a competing implementation of markers used exclusively by the Firefox Devtools that are recorded per DocShell. These are not currently integrated into the Firefox Profiler.
-
-- [Timeline C++ Implementation](https://dxr.mozilla.org/mozilla-central/source/docshell/base/timeline)
-- [Timeline Devtools JS Server](https://dxr.mozilla.org/mozilla-central/source/devtools/server/performance/timeline.ts)
-
-## Tracelogger (unused in the Firefox Profiler)
-
-While the previous performance tools collect information about how Gecko runs as a whole, Tracelogger is specific to the SpiderMonkey engine. Tracelogger is not sample based, therefore it records every step that the SpiderMonkey engine performs to run a given chunk of JavaScript code. It's primarily used by JavaScript engineers, and includes a firehose of information often reaching into the several gigs of information. There is no current integration of this information with the Firefox Profiler.
-
-- [Tracelogger on GitHub](https://github.com/h4writer/tracelogger)
+- [nsIProfiler.idl](https://searchfox.org/firefox-main/source/tools/profiler/gecko/nsIProfiler.idl)
+- [ProfileBufferEntry.h](https://searchfox.org/firefox-main/rev/5ccf4a7d77a329f237d3a41e400049f9c47dc71f/tools/profiler/core/ProfileBufferEntry.h#433-566)
+- [Gecko Profile Data Format](./gecko-profile-format.md)
diff --git a/docs-developer/gecko-profile-format.md b/docs-developer/gecko-profile-format.md
@@ -326,6 +326,6 @@ funcTable: {
 }
 ```
 
-[nsIProfiler]: https://dxr.mozilla.org/mozilla-central/source/tools/profiler/gecko/nsIProfiler.idl
+[nsIProfiler]: https://searchfox.org/firefox-main/source/tools/profiler/gecko/nsIProfiler.idl
 [ProfileBufferEntry.h]: https://searchfox.org/mozilla-central/rev/5966e98bdfa7355e0a3d9cce482f4717dc3419b0/tools/profiler/core/ProfileBufferEntry.h#358
 [profiler.firefox.com]: https://profiler.firefox.com
diff --git a/jest.config.js b/jest.config.js
@@ -0,0 +1,40 @@
+/* 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/. */
+
+module.exports = {
+  testMatch: ['<rootDir>/src/**/*.test.{js,jsx,ts,tsx}'],
+  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx'],
+
+  testEnvironment: './src/test/custom-environment',
+  setupFilesAfterEnv: ['jest-extended/all', './src/test/setup.ts'],
+
+  collectCoverageFrom: [
+    'src/**/*.{js,jsx,ts,tsx}',
+    '!**/node_modules/**',
+    '!src/types/libdef/**',
+  ],
+
+  // Transform ESM modules to CommonJS for Jest
+  // These packages ship as pure ESM and need to be transformed by Babel
+  transformIgnorePatterns: [
+    '/node_modules/(?!(query-string|decode-uri-component|iongraph-web|split-on-first|filter-obj|fetch-mock)/)',
+  ],
+
+  // Mock static assets (images, CSS, etc.)
+  moduleNameMapper: {
+    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga|ftl)$':
+      '<rootDir>/src/test/fixtures/mocks/file-mock.ts',
+    '\\.(css|less)$': '<rootDir>/src/test/fixtures/mocks/style-mock.ts',
+  },
+
+  globals: {
+    AVAILABLE_STAGING_LOCALES: null,
+  },
+
+  snapshotFormat: {
+    escapeString: true,
+    printBasicPrototype: true,
+  },
+  verbose: false,
+};
diff --git a/locales/en-CA/app.ftl b/locales/en-CA/app.ftl
@@ -42,6 +42,14 @@ AppViewRouter--error-from-localhost-url-safari =
 AppViewRouter--route-not-found--home =
     .specialMessage = The URL you tried to reach was not recognized.
 
+## Backtrace
+## This is used to display a backtrace (call stack) for a marker or sample.
+
+# Variables:
+#   $function (String) - Name of the function that was inlined.
+Backtrace--inlining-badge = (inlined)
+    .title = { $function } was inlined into its caller by the compiler.
+
 ## CallNodeContextMenu
 ## This is used as a context menu for the Call Tree, Flame Graph and Stack Chart
 ## panels.
@@ -443,6 +451,16 @@ MarkerTable--duration = Duration
 MarkerTable--name = Name
 MarkerTable--details = Details
 
+## MarkerTooltip
+## This is the component for Marker Tooltip panel.
+
+# This is used as the tooltip for the filter button in marker tooltips.
+# Variables:
+#   $filter (String) - Search string that will be used to filter the markers.
+MarkerTooltip--filter-button-tooltip =
+    .title = Only show markers matching: “{ $filter }”
+    .aria-label = Only show markers matching: “{ $filter }”
+
 ## MenuButtons
 ## These strings are used for the buttons at the top of the profile viewer.
 
@@ -519,6 +537,8 @@ MenuButtons--metaInfo--profiling-started = Recording started:
 MenuButtons--metaInfo--profiling-session = Recording length:
 MenuButtons--metaInfo--main-process-started = Main process started:
 MenuButtons--metaInfo--main-process-ended = Main process ended:
+MenuButtons--metaInfo--file-name = File name:
+MenuButtons--metaInfo--file-size = File size:
 MenuButtons--metaInfo--interval = Interval:
 MenuButtons--metaInfo--buffer-capacity = Buffer capacity:
 MenuButtons--metaInfo--buffer-duration = Buffer duration:
@@ -1125,6 +1145,13 @@ SourceView--not-in-archive-error-when-obtaining-source = The file { $pathInArchi
 #   $url (String) - The URL from which the "archive" file was downloaded.
 #   $parsingErrorMessage (String) - The raw internal error message during parsing, not localized
 SourceView--archive-parsing-error-when-obtaining-source = The archive at { $url } could not be parsed: { $parsingErrorMessage }
+# Displayed below SourceView--cannot-obtain-source, if a JS file could not be found in
+# the browser.
+# Variables:
+#   $url (String) - The URL of the JS source file.
+#   $sourceUuid (number) - The UUID of the JS source file.
+#   $errorMessage (String) - The raw internal error message, not localized
+SourceView--not-in-browser-error-when-obtaining-js-source = The browser was unable to obtain the source file for { $url } with sourceUuid { $sourceUuid }: { $errorMessage }.
 
 ## Toggle buttons in the top right corner of the bottom box
 

diff --git a/locales/es-CL/app.ftl b/locales/es-CL/app.ftl
@@ -468,6 +468,8 @@ MenuButtons--metaInfo--profiling-started = Inicio del registro:
 MenuButtons--metaInfo--profiling-session = Duración del registro:
 MenuButtons--metaInfo--main-process-started = Proceso principal iniciado:
 MenuButtons--metaInfo--main-process-ended = Proceso principal terminado:
+MenuButtons--metaInfo--file-name = Nombre de archivo:
+MenuButtons--metaInfo--file-size = Tamaño del archivo:
 MenuButtons--metaInfo--interval = Intervalo:
 MenuButtons--metaInfo--buffer-capacity = Capacidad del búfer:
 MenuButtons--metaInfo--buffer-duration = Duración del búfer: