chrome-devtools-frontend 1.0.1703574 → 1.0.1705227

package/AUTHORS

@@ -99,6 +99,7 @@ Ryuhei Shima <shimaryuhei@gmail.com>
 Samuel Maddock <samuelmaddock@electronjs.org>
 Satvic Dhawan <satvicdhawan14@gmail.com>
 Sebastian Markbåge <sebastian@calyptus.eu>
+Semih Dogan <semih702do@gmail.com>
 Serg Kryvonos <sergeikrivonos@gmail.com>
 Sergio Avalos <sergio.avalos@gmail.com>
 Shelley Vohr <shelley.vohr@gmail.com>
@@ -123,6 +124,7 @@ Yoichiro Hibara <hibarayoichiro871@gmail.com>
 Yoni Feigelson <yfeigelson@gmail.com>
 Young Min Kim <y@ylem.kim>
 Yuan Zhuang <joann.yuanzhuang@gmail.com>
+Zeeshan Ahmad <zeeshanahmad125114@gmail.com>
 Zuyao Chen <zuyaocat@gmail.com>
 # Please DO NOT APPEND here. See comments at the top of the file.
 # END individuals section.

package/docs/architecture_of_devtools.md

@@ -121,7 +121,7 @@ There are multiple variants of the DevTools application.
 The main DevTools application is [devtools_app.ts](../front_end/entrypoints/devtools_app/devtools_app.ts), which developers can open via F12 or "Right click -> Inspect element" in their Chromium browser.
 Other application entrypoints are a dedicated tool for debugging Node on which multiple targets can be inspected ([node_app.ts](../front_end/entrypoints/node_app/node_app.ts)), a non-browser context debugger for V8 targets ([js_app.ts](../front_end/entrypoints/js_app/js_app.ts)), a (service) worker context ([worker_app.ts](../front_end/entrypoints/worker_app/worker_app.ts)), remote debugging of (Android) devices ([inspector.ts](../front_end/entrypoints/inspector/inspector.ts)) and a basic version of DevTools which was initially intended for non-browser targets but doesn't have any particular use case that differentiates it from the other variants ([ndb_app.ts](../front_end/entrypoints/ndb_app/ndb_app.ts)).
 
-Each application entrypoint has a corresponding `.html` file with the same name, that is automatically in the frontend generated and can be loaded by the Chromium DevTools backend.
+Each application entrypoint has a corresponding `.html` file with the same name, that is automatically generated in the frontend and can be loaded by the Chromium DevTools backend.
 The JavaScript files import the relevant "meta" files containing the declarations of DevTools features.
 
 ## Upfront declaration of DevTools features

package/docs/cookbook/localization.md

@@ -286,8 +286,8 @@ const UIStrings = {
 
 ## How to prevent a term being localized
 
-Any text within the backticks will not be translated. For example, if the
-'robots.txt' in string 'Requesting for robots.txt …' should not be translated:
+Any text within the backticks will not be translated. For example,
+'robots.txt' in the string 'Requesting for robots.txt …' should not be translated:
 
 ```ts
 // in example.js file

package/front_end/core/common/ParsedURL.ts

@@ -46,6 +46,60 @@ export function schemeIs(url: Platform.DevToolsPath.UrlString|URL, scheme: strin
   }
 }
 
+/**
+ * Schemes safe for unprivileged web contexts (matching ChildProcessSecurityPolicyImpl::RegisterDefaultSchemes).
+ */
+const WEB_SAFE_SCHEMES = new Set([
+  'http:',
+  'https:',
+  'ws:',
+  'wss:',
+  'data:',
+]);
+
+/**
+ * Returns true if the URL uses an unprivileged web-safe scheme (or is a `blob:` URL wrapping one).
+ */
+export function hasWebSafeScheme(url: Platform.DevToolsPath.UrlString|URL|string): boolean {
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol === 'blob:') {
+      return hasWebSafeScheme(parsed.pathname);
+    }
+    return WEB_SAFE_SCHEMES.has(parsed.protocol);
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Privileged browser and local schemes that must not be opened via external/new-tab links by default.
+ */
+const PRIVILEGED_SCHEMES = new Set([
+  'chrome:',
+  'chrome-extension:',
+  'chrome-search:',
+  'chrome-untrusted:',
+  'devtools:',
+  'file:',
+  'isolated-app:',
+]);
+
+/**
+ * Returns true if the URL uses a privileged scheme (or is a `blob:` URL wrapping one).
+ */
+export function isPrivilegedScheme(url: Platform.DevToolsPath.UrlString|URL|string): boolean {
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol === 'blob:') {
+      return isPrivilegedScheme(parsed.pathname);
+    }
+    return PRIVILEGED_SCHEMES.has(parsed.protocol);
+  } catch {
+    return false;
+  }
+}
+
 /**
  * File paths in DevTools that are represented either as unencoded absolute or relative paths, or encoded paths, or URLs.
  * @example

package/front_end/core/common/README.md

@@ -6,14 +6,15 @@ A settings registration is represented by the `SettingRegistration` interface, d
 
 All settings have to be registered using the function `Common.Settings.registerSettingExtension` which expects an object of type `SettingRegistration` as parameter.
 
-As an example, take the registration of the `showHTMLComments` setting, which allows users to determine if HTML comments are shown in the Elements tree:
+As an example, take the registration of the `show-html-comments` setting, which allows users to determine if HTML comments are shown in the Elements tree:
 
 ```ts
 Common.Settings.registerSettingExtension({
   category: Common.Settings.SettingCategory.ELEMENTS,
+  storageType: Common.Settings.SettingStorageType.SYNCED,
   order: 3,
-  title: ls`Show HTML comments`,
-  settingName: 'showHTMLComments',
+  title: ls`HTML comments`,
+  settingName: 'show-html-comments',
   settingType: Common.Settings.SettingType.BOOLEAN,
   defaultValue: true,
   options: [

package/front_end/core/platform/StringUtilities.ts

@@ -740,3 +740,68 @@ export const concatBase64 = function(lhs: string, rhs: string): string {
   const lhsToDecode = lhs.substring(lhs.length - 4);
   return lhsLeaveAsIs + globalThis.btoa(globalThis.atob(lhsToDecode) + globalThis.atob(rhs));
 };
+
+/**
+ * Characters that cause spreadsheet viewers (Excel, Google Sheets, LibreOffice
+ * Calc) to evaluate a cell as a formula rather than rendering it as plain text
+ * when they appear at the start of a cell.
+ */
+const CSV_FORMULA_TRIGGERS = new Set(['=', '+', '-', '@', '\t', '\r']);
+
+/**
+ * Matches plain numeric literals (e.g. `-42`, `+3.14`, `-1e-3`).
+ * Even though negative/signed numbers start with `-` or `+`, spreadsheets parse
+ * them as numbers rather than formulas, so we exempt them from `'` prefixing to
+ * keep numeric columns usable.
+ */
+const CSV_PLAIN_NUMBER = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/;
+
+/**
+ * Returns true if a spreadsheet viewer could interpret `value` as a formula
+ * (for example `=SUM(A1:A2)`, `"- Loading..."`, or `"@alice"`).
+ */
+function isCsvFormula(value: string): boolean {
+  // Check both the raw string and the leading-whitespace-trimmed string, since
+  // some spreadsheet parsers ignore leading spaces before `=`, `+`, `-`, or `@`.
+  const trimmed = value.trimStart();
+  if (!CSV_FORMULA_TRIGGERS.has(value[0]) && !CSV_FORMULA_TRIGGERS.has(trimmed[0])) {
+    return false;
+  }
+  return !CSV_PLAIN_NUMBER.test(trimmed.trimEnd());
+}
+
+/**
+ * Formats and escapes `value` so it can be safely written as a single CSV cell.
+ *
+ * This handles two separate layers of escaping:
+ * 1. Spreadsheet formula escaping (CWE-1236 & viewer fidelity):
+ *    RFC 4180 double-quoting (`"=1+1"` or `"- Loading..."`) only groups text
+ *    into a single CSV column; spreadsheet apps strip the outer `"` and still
+ *    evaluate cells starting with `=`, `+`, `-`, or `@` as formulas (often
+ *    resulting in `#NAME?` errors or unintended formula execution). Prefixing
+ *    the value with a single quote (`'`) tells spreadsheet apps to treat the
+ *    cell as literal text (and they hide the leading `'` when displaying it).
+ *    - Example without commas: `=SUM(A1:A2)` -> `'=SUM(A1:A2)`
+ * 2. RFC 4180 structural CSV quoting:
+ *    If the cell also contains commas (`,`), double quotes (`"`), or newlines,
+ *    it is wrapped in `"..."` (with inner `"` doubled to `""`) so CSV parsers
+ *    do not split the cell across columns or rows.
+ *    - Example with commas: `=SUM(1,2)` -> `"'=SUM(1,2)"`
+ *    - Example starting with a literal quote: `"=SUM(1,2)"` -> `"""=SUM(1,2)"""`
+ *      (not treated as a formula since the first character is `"`, not `=`).
+ */
+export const escapeCsvCell = function(value: string): string {
+  // Step 1: Prefix formula-like text with `'` so spreadsheets render it as literal text.
+  let escaped = isCsvFormula(value) ? `'${value}` : value;
+
+  // Step 2: Apply standard RFC 4180 double-quoting if the cell contains quotes,
+  // commas, or line breaks so the CSV structure stays intact.
+  if (escaped.includes('"')) {
+    escaped = escaped.replace(/"/g, '""');
+    return `"${escaped}"`;
+  }
+  if (escaped.includes(',') || escaped.includes('\n') || escaped.includes('\r')) {
+    return `"${escaped}"`;
+  }
+  return escaped;
+};

package/front_end/core/sdk/CPUThrottlingManager.ts

@@ -282,9 +282,9 @@ export class CPUThrottlingManager extends Common.ObjectWrapper.ObjectWrapper<Eve
   }
 
   async updateHostDefaultCPUPerformanceTier(): Promise<void> {
-    if (this.#manualCPUPerformanceOverride !== undefined) {
-      // We do not want to update the host default tier when it is manually overridden
-      // via the sensors panel (in which case, `navigator.cpuPerformance` would return the override).
+    if (this.#isCPUPerformanceOverrideActive()) {
+      // We do not want to update the host default tier when it is overridden
+      // (in which case, `navigator.cpuPerformance` would return the override).
       return;
     }
     const target = this.#targetManager.primaryPageTarget();

package/front_end/core/sdk/SourceMap.ts

@@ -12,7 +12,7 @@ import {scopeTreeForScript} from './ScopeTreeCache.js';
 import type {Script} from './Script.js';
 import {buildOriginalScopes, decodePastaRanges, type NamedFunctionRange} from './SourceMapFunctionRanges.js';
 import {decodeRangeMappings} from './SourceMapRangeMappings.js';
-import {SourceMapScopesInfo, type TranslatedFrame} from './SourceMapScopesInfo.js';
+import {scriptRelativePosition, SourceMapScopesInfo, type TranslatedFrame} from './SourceMapScopesInfo.js';
 
 /**
  * Type of the base source map JSON object, which contains the sources and the mappings at the very least, plus
@@ -850,8 +850,8 @@ export class SourceMap {
       return null;
     }
 
-    return this.#scopesInfo.resolveMappedVariablesAtPosition(location.lineNumber, location.columnNumber,
-                                                             ignoreInnerBlockScopes);
+    const {line, column} = scriptRelativePosition(location);
+    return this.#scopesInfo.resolveMappedVariablesAtPosition(line, column, ignoreInnerBlockScopes);
   }
 
   findOriginalFunctionName(position: ScopesCodec.Position): string|null {

package/front_end/core/sdk/SourceMapScopeChainEntry.ts

@@ -8,7 +8,7 @@ import * as i18n from '../i18n/i18n.js';
 
 import type {CallFrame, LocationRange, ScopeChainEntry} from './DebuggerModel.js';
 import {type GetPropertiesResult, type RemoteObject, RemoteObjectImpl, RemoteObjectProperty} from './RemoteObject.js';
-import {findExpression} from './SourceMapScopesInfo.js';
+import {findExpression, scriptRelativePosition} from './SourceMapScopesInfo.js';
 
 const UIStrings = {
   /**
@@ -263,8 +263,9 @@ class SourceMapScopeRemoteObject extends RemoteObjectImpl {
 
   /** @returns null if the variable is unavailable at the current paused location */
   #findExpression(index: number): string|null {
-    const pausedPosition = this.#callFrame.location();
-    return findExpression(this.#range, index, pausedPosition?.lineNumber, pausedPosition?.columnNumber);
+    const pausedLocation = this.#callFrame.location();
+    const pausedPosition = pausedLocation ? scriptRelativePosition(pausedLocation) : undefined;
+    return findExpression(this.#range, index, pausedPosition?.line, pausedPosition?.column);
   }
 
   static #unavailableProperty(name: string): RemoteObjectProperty {

package/front_end/core/sdk/SourceMapScopesInfo.ts

@@ -8,7 +8,7 @@ import type * as ScopesCodec from '../../third_party/source-map-scopes-codec/sou
 import type * as Platform from '../platform/platform.js';
 import type * as TextUtils from '../text_utils/text_utils.js';
 
-import type {CallFrame, Scope, ScopeChainEntry} from './DebuggerModel.js';
+import type {CallFrame, Location, Scope, ScopeChainEntry} from './DebuggerModel.js';
 import type {SourceMap} from './SourceMap.js';
 import {SourceMapScopeChainEntry} from './SourceMapScopeChainEntry.js';
 
@@ -389,8 +389,8 @@ export class SourceMapScopesInfo {
 
   /** Similar to #findGeneratedRangeChain, but takes inlineFrameIndex of virtual call frames into account */
   #findGeneratedRangeChainForFrame(callFrame: CallFrame): ScopesCodec.GeneratedRange[] {
-    const rangeChain =
-        this.#findGeneratedRangeChain(callFrame.location().lineNumber, callFrame.location().columnNumber);
+    const {line, column} = scriptRelativePosition(callFrame.location());
+    const rangeChain = this.#findGeneratedRangeChain(line, column);
     if (callFrame.inlineFrameIndex === 0) {
       return rangeChain;
     }
@@ -611,6 +611,18 @@ export function comparePositions(a: ScopesCodec.Position, b: ScopesCodec.Positio
   return a.column - b.column;
 }
 
+/**
+ * Converts a raw V8 {@link location} into a generated position relative to the start of its script.
+ *
+ * Positions in source maps (mappings and generated ranges) are relative to the start of the script,
+ * while V8 reports locations in inline `<script>`s (without `//# sourceURL`) relative to the start of
+ * the surrounding document.
+ */
+export function scriptRelativePosition(location: Location): ScopesCodec.Position {
+  const {lineNumber, columnNumber} = location.script()?.rawLocationToRelativeLocation(location) ?? location;
+  return {line: lineNumber, column: columnNumber};
+}
+
 function positionRange(callFrame: CallFrame, scope: Scope): {start: ScopesCodec.Position, end: ScopesCodec.Position}|
     null {
   const range = scope.range();
@@ -619,8 +631,8 @@ function positionRange(callFrame: CallFrame, scope: Scope): {start: ScopesCodec.
     return null;
   }
   return {
-    start: {line: range.start.lineNumber, column: range.start.columnNumber},
-    end: {line: range.end.lineNumber, column: range.end.columnNumber},
+    start: scriptRelativePosition(range.start),
+    end: scriptRelativePosition(range.end),
   };
 }
 

package/front_end/entrypoints/formatter_actions/formatter_actions.ts

@@ -51,6 +51,24 @@ export const enum ScopeKind {
   ARROW_FUNCTION = 4,
 }
 
+/**
+ * Describes a single scope for `javaScriptSubstitute`.
+ */
+export interface ScopeVariableMapping {
+  /**
+   * Authored variable name -> generated binding expression, or `null` if the variable is unavailable.
+   */
+  bindings: Map<string, string|null>;
+  /**
+   * Generated identifiers declared by this scope. Together with the free identifiers of `bindings`, these
+   * shadow bindings of outer scopes that refer to the same generated identifiers.
+   *
+   * This is needed when a generated identifier doesn't show up in any binding expression, e.g. because
+   * multiple generated identifiers map to the same authored name, or the authored name is unknown.
+   */
+  generatedNames: string[];
+}
+
 export interface ScopeTreeNode {
   variables: Array<{name: string, kind: DefinitionKind, offsets: number[]}>;
   start: number;

package/front_end/entrypoints/formatter_worker/Substitute.ts

@@ -3,13 +3,13 @@
 // found in the LICENSE file.
 
 import * as Acorn from '../../third_party/acorn/acorn.js';
-import {DefinitionKind} from '../formatter_actions/formatter_actions.js';
+import {DefinitionKind, type ScopeVariableMapping} from '../formatter_actions/formatter_actions.js';
 
 import {ECMA_VERSION} from './AcornTokenizer.js';
 import {ScopeVariableAnalysis, type VariableUses} from './ScopeParser.js';
 
-export function substituteExpression(expression: string, nameMaps: Array<Map<string, string|null>>): string {
-  const replacements = computeSubstitution(expression, nameMaps);
+export function substituteExpression(expression: string, scopes: ScopeVariableMapping[]): string {
+  const replacements = computeSubstitution(expression, scopes);
   return applySubstitution(expression, replacements);
 }
 
@@ -52,12 +52,12 @@ function parseBindingExpression(expression: string): {
 }
 
 /**
- * Given an |expression| and a mapping from names to new names, the |computeSubstitution|
+ * Given an |expression| and a list of |scopes| (from inner-most to outer-most), the |computeSubstitution|
  * function returns a list of replacements sorted by the offset. The function throws if
  * it cannot parse the expression or the substitution is impossible to perform (for example
  * if the substitution target is 'this' within a function, it would become bound there).
  **/
-function computeSubstitution(expression: string, nameMaps: Array<Map<string, string|null>>): Replacement[] {
+function computeSubstitution(expression: string, scopes: ScopeVariableMapping[]): Replacement[] {
   // Parse the expression and find variables and scopes.
   const root = Acorn.parse(expression, {
     ecmaVersion: ECMA_VERSION,
@@ -75,10 +75,11 @@ function computeSubstitution(expression: string, nameMaps: Array<Map<string, str
   const allNames = scopeVariables.getAllNames();
   const nameMap = new Map<string, string|null>();
   const parsedBindings = new Map<string, ReturnType<typeof parseBindingExpression>>();
+  // Generated identifiers declared by the scopes visited so far. Outer bindings referring to them are shadowed.
   const shadowedNames = new Set<string>();
-  for (const scopeMap of nameMaps) {
-    const scopeNames = new Set<string>();
-    for (const [name, rename] of scopeMap.entries()) {
+  for (const {bindings, generatedNames} of scopes) {
+    const scopeNames = new Set<string>(generatedNames);
+    for (const [name, rename] of bindings.entries()) {
       let parsed: ReturnType<typeof parseBindingExpression>|undefined;
       if (rename !== null) {
         try {

package/front_end/entrypoints/formatter_worker/formatter_worker-entrypoint.ts

@@ -3,7 +3,7 @@
 // found in the LICENSE file.
 
 import * as Platform from '../../core/platform/platform.js';
-import {FormatterActions} from '../formatter_actions/formatter_actions.js';
+import {FormatterActions, type ScopeVariableMapping} from '../formatter_actions/formatter_actions.js';
 
 import * as FormatterWorker from './formatter_worker.js';
 
@@ -13,7 +13,7 @@ Platform.HostRuntime.HOST_RUNTIME.workerScope.onmessage = function(event): void
     indentString: string,
     content: string,
     mimeType: string,
-    mapping: Array<Map<string, string|null>>,
+    mapping: ScopeVariableMapping[],
     sourceType: 'module'|'script',
   } = event.data.params;
   if (!method) {

package/front_end/entrypoints/main/MainImpl.ts

@@ -121,9 +121,9 @@ const UIStrings = {
    */
   aiModelDownloaded: 'AI model downloaded',
   /**
-   * @description Title of the menu item in the customize and control menu leading to the DevTools MCP repository.
+   * @description Title of the menu item in the customize and control menu leading to the Chrome DevTools for agents repository.
    */
-  getDevToolsMcp: 'Get `DevTools MCP`',
+  getChromeDevToolsForAgents: 'Give your agent access to `DevTools`',
 } as const;
 const str_ = i18n.i18n.registerUIStrings('entrypoints/main/MainImpl.ts', UIStrings);
 const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
@@ -893,7 +893,7 @@ export class MainMenuItem implements UI.Toolbar.Provider {
 
     contextMenu.defaultSection().appendAction('freestyler.main-menu', undefined, /* optional */ true);
 
-    contextMenu.defaultSection().appendItem(i18nString(UIStrings.getDevToolsMcp), () => {
+    contextMenu.defaultSection().appendItem(i18nString(UIStrings.getChromeDevToolsForAgents), () => {
       UIHelpers.openInNewTab('https://github.com/ChromeDevTools/chrome-devtools-mcp');
     }, {
       additionalElement: UI.UIUtils.maybeCreateNewBadge('get-devtools-mcp'),

package/front_end/foundation/Universe.ts

@@ -21,6 +21,7 @@ import * as LiveMetrics from '../models/live-metrics/live-metrics.js';
 import * as Logs from '../models/logs/logs.js';
 import * as Persistence from '../models/persistence/persistence.js';
 import * as ProjectSettings from '../models/project_settings/project_settings.js';
+import * as SourceMapScopes from '../models/source_map_scopes/source_map_scopes.js';
 import * as Workspace from '../models/workspace/workspace.js';
 import * as WorkspaceDiff from '../models/workspace_diff/workspace_diff.js';
 
@@ -160,6 +161,10 @@ export class Universe {
         resourceMapping, targetManager, ignoreListManager, workspace);
     context.set(Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding, debuggerWorkspaceBinding);
 
+    const scopeChainResolver =
+        new SourceMapScopes.ScopeChainResolver.ScopeChainResolver(targetManager, debuggerWorkspaceBinding);
+    context.set(SourceMapScopes.ScopeChainResolver.ScopeChainResolver, scopeChainResolver);
+
     const presentationConsoleMessageManager =
         new Bindings.PresentationConsoleMessageHelper.PresentationConsoleMessageManager(
             targetManager, workspace, debuggerWorkspaceBinding, cssWorkspaceBinding);
@@ -383,6 +388,10 @@ export class Universe {
                                           null;
   }
 
+  get scopeChainResolver(): SourceMapScopes.ScopeChainResolver.ScopeChainResolver {
+    return this.context.get(SourceMapScopes.ScopeChainResolver.ScopeChainResolver);
+  }
+
   get settings(): Common.Settings.Settings {
     return this.context.get(Common.Settings.Settings);
   }

package/front_end/generated/InspectorBackendCommands.ts

@@ -545,7 +545,8 @@ inspectorBackend.registerCommand("Emulation.setSafeAreaInsetsOverride", [{"name"
 inspectorBackend.registerCommand("Emulation.setVirtualKeyboardGeometryOverride", [{"name": "keyboardRect", "type": "object", "optional": true, "description": "", "typeRef": "DOM.Rect"}], [], "Overrides virtual keyboard geometry in CSS pixels, relative to the top-level viewport. The provided rect is used for navigator.virtualKeyboard.boundingRect, geometrychange events, and env(keyboard-inset-*) values on the inspected frame. The override applies independently of navigator.virtualKeyboard.overlaysContent so clients can preview overlay geometry without mutating page state. Values are rounded to the nearest CSS pixel. Omitting the rect clears the override.");
 inspectorBackend.registerEnum("Emulation.SetDeviceMetricsOverrideRequestScrollbarType", {Overlay: "overlay", Default: "default"});
 inspectorBackend.registerEnum("Emulation.SetDeviceMetricsOverrideRequestViewportMeta", {Enable: "enable", Default: "default"});
-inspectorBackend.registerCommand("Emulation.setDeviceMetricsOverride", [{"name": "width", "type": "number", "optional": false, "description": "Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.", "typeRef": null}, {"name": "height", "type": "number", "optional": false, "description": "Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.", "typeRef": null}, {"name": "deviceScaleFactor", "type": "number", "optional": false, "description": "Overriding device scale factor value. 0 disables the override.", "typeRef": null}, {"name": "mobile", "type": "boolean", "optional": false, "description": "Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.", "typeRef": null}, {"name": "scale", "type": "number", "optional": true, "description": "Scale to apply to resulting view image.", "typeRef": null}, {"name": "screenWidth", "type": "number", "optional": true, "description": "Overriding screen width value in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "screenHeight", "type": "number", "optional": true, "description": "Overriding screen height value in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "positionX", "type": "number", "optional": true, "description": "Overriding view X position on screen in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "positionY", "type": "number", "optional": true, "description": "Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "dontSetVisibleSize", "type": "boolean", "optional": true, "description": "Do not set visible view size, rely upon explicit setVisibleSize call.", "typeRef": null}, {"name": "screenOrientation", "type": "object", "optional": true, "description": "Screen orientation override.", "typeRef": "Emulation.ScreenOrientation"}, {"name": "viewport", "type": "object", "optional": true, "description": "If set, the visible area of the page will be overridden to this viewport. This viewport change is not observed by the page, e.g. viewport-relative elements do not change positions.", "typeRef": "Page.Viewport"}, {"name": "displayFeature", "type": "object", "optional": true, "description": "If set, the display feature of a multi-segment screen. If not set, multi-segment support is turned-off. Deprecated, use Emulation.setDisplayFeaturesOverride.", "typeRef": "Emulation.DisplayFeature"}, {"name": "devicePosture", "type": "object", "optional": true, "description": "If set, the posture of a foldable device. If not set the posture is set to continuous. Deprecated, use Emulation.setDevicePostureOverride.", "typeRef": "Emulation.DevicePosture"}, {"name": "scrollbarType", "type": "string", "optional": true, "description": "Scrollbar type. Default: `default`.", "typeRef": "Emulation.SetDeviceMetricsOverrideRequestScrollbarType"}, {"name": "screenOrientationLockEmulation", "type": "boolean", "optional": true, "description": "If set to true, enables screen orientation lock emulation, which intercepts screen.orientation.lock() calls from the page and reports orientation changes via screenOrientationLockChanged events. This is useful for emulating mobile device orientation lock behavior in responsive design mode.", "typeRef": null}, {"name": "viewportMeta", "type": "string", "optional": true, "description": "Viewport meta tag behavior. Default: `default`. Note: if `mobile` is `true`, the viewport meta tag is always enabled.", "typeRef": "Emulation.SetDeviceMetricsOverrideRequestViewportMeta"}], [], "Overrides the values of device screen dimensions (window.screen.width, window.screen.height, window.innerWidth, window.innerHeight, and \"device-width\"/\"device-height\"-related CSS media query results).");
+inspectorBackend.registerEnum("Emulation.SetDeviceMetricsOverrideRequestTextLayoutMode", {Mobile: "mobile", Default: "default"});
+inspectorBackend.registerCommand("Emulation.setDeviceMetricsOverride", [{"name": "width", "type": "number", "optional": false, "description": "Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.", "typeRef": null}, {"name": "height", "type": "number", "optional": false, "description": "Overriding height value in pixels (minimum 0, maximum 10000000). 0 disables the override.", "typeRef": null}, {"name": "deviceScaleFactor", "type": "number", "optional": false, "description": "Overriding device scale factor value. 0 disables the override.", "typeRef": null}, {"name": "mobile", "type": "boolean", "optional": false, "description": "Whether to emulate mobile device. This includes viewport meta tag, overlay scrollbars, text autosizing and more.", "typeRef": null}, {"name": "scale", "type": "number", "optional": true, "description": "Scale to apply to resulting view image.", "typeRef": null}, {"name": "screenWidth", "type": "number", "optional": true, "description": "Overriding screen width value in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "screenHeight", "type": "number", "optional": true, "description": "Overriding screen height value in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "positionX", "type": "number", "optional": true, "description": "Overriding view X position on screen in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "positionY", "type": "number", "optional": true, "description": "Overriding view Y position on screen in pixels (minimum 0, maximum 10000000).", "typeRef": null}, {"name": "dontSetVisibleSize", "type": "boolean", "optional": true, "description": "Do not set visible view size, rely upon explicit setVisibleSize call.", "typeRef": null}, {"name": "screenOrientation", "type": "object", "optional": true, "description": "Screen orientation override.", "typeRef": "Emulation.ScreenOrientation"}, {"name": "viewport", "type": "object", "optional": true, "description": "If set, the visible area of the page will be overridden to this viewport. This viewport change is not observed by the page, e.g. viewport-relative elements do not change positions.", "typeRef": "Page.Viewport"}, {"name": "displayFeature", "type": "object", "optional": true, "description": "If set, the display feature of a multi-segment screen. If not set, multi-segment support is turned-off. Deprecated, use Emulation.setDisplayFeaturesOverride.", "typeRef": "Emulation.DisplayFeature"}, {"name": "devicePosture", "type": "object", "optional": true, "description": "If set, the posture of a foldable device. If not set the posture is set to continuous. Deprecated, use Emulation.setDevicePostureOverride.", "typeRef": "Emulation.DevicePosture"}, {"name": "scrollbarType", "type": "string", "optional": true, "description": "Scrollbar type. Default: `default`.", "typeRef": "Emulation.SetDeviceMetricsOverrideRequestScrollbarType"}, {"name": "screenOrientationLockEmulation", "type": "boolean", "optional": true, "description": "If set to true, enables screen orientation lock emulation, which intercepts screen.orientation.lock() calls from the page and reports orientation changes via screenOrientationLockChanged events. This is useful for emulating mobile device orientation lock behavior in responsive design mode.", "typeRef": null}, {"name": "viewportMeta", "type": "string", "optional": true, "description": "Viewport meta tag behavior. Default: `default`. Note: if `mobile` is `true`, the viewport meta tag is always enabled.", "typeRef": "Emulation.SetDeviceMetricsOverrideRequestViewportMeta"}, {"name": "textLayoutMode", "type": "string", "optional": true, "description": "Text layout mode. Default: `default`. Note: if `mobile` is `true`, mobile text layout mode (text autosizing) is always enabled.", "typeRef": "Emulation.SetDeviceMetricsOverrideRequestTextLayoutMode"}], [], "Overrides the values of device screen dimensions (window.screen.width, window.screen.height, window.innerWidth, window.innerHeight, and \"device-width\"/\"device-height\"-related CSS media query results).");
 inspectorBackend.registerCommand("Emulation.setDevicePostureOverride", [{"name": "posture", "type": "object", "optional": false, "description": "", "typeRef": "Emulation.DevicePosture"}], [], "Start reporting the given posture value to the Device Posture API. This override can also be set in setDeviceMetricsOverride().");
 inspectorBackend.registerCommand("Emulation.clearDevicePostureOverride", [], [], "Clears a device posture override set with either setDeviceMetricsOverride() or setDevicePostureOverride() and starts using posture information from the platform again. Does nothing if no override is set.");
 inspectorBackend.registerCommand("Emulation.setDisplayFeaturesOverride", [{"name": "features", "type": "array", "optional": false, "description": "", "typeRef": "Emulation.DisplayFeature"}], [], "Start using the given display features to pupulate the Viewport Segments API. This override can also be set in setDeviceMetricsOverride().");
@@ -1240,7 +1241,7 @@ inspectorBackend.registerEvent("Preload.ruleSetUpdated", ["ruleSet"]);
 inspectorBackend.registerEvent("Preload.ruleSetRemoved", ["id"]);
 inspectorBackend.registerEvent("Preload.preloadEnabledStateUpdated", ["disabledByPreference", "disabledByDataSaver", "disabledByBatterySaver", "disabledByHoldbackPrefetchSpeculationRules", "disabledByHoldbackPrerenderSpeculationRules"]);
 inspectorBackend.registerEvent("Preload.prefetchStatusUpdated", ["key", "pipelineId", "initiatingFrameId", "prefetchUrl", "status", "prefetchStatus", "requestId"]);
-inspectorBackend.registerEvent("Preload.prerenderStatusUpdated", ["key", "pipelineId", "status", "prerenderStatus", "disallowedMojoInterface", "mismatchedHeaders"]);
+inspectorBackend.registerEvent("Preload.prerenderStatusUpdated", ["key", "pipelineId", "status", "effectiveAction", "prerenderStatus", "disallowedMojoInterface", "mismatchedHeaders"]);
 inspectorBackend.registerEvent("Preload.preloadingAttemptSourcesUpdated", ["loaderId", "preloadingAttemptSources"]);
 inspectorBackend.registerCommand("Preload.enable", [], [], "");
 inspectorBackend.registerCommand("Preload.disable", [], [], "");

package/front_end/generated/protocol.ts

@@ -7517,6 +7517,11 @@ export namespace Emulation {
     Default = 'default',
   }
 
+  export const enum SetDeviceMetricsOverrideRequestTextLayoutMode {
+    Mobile = 'mobile',
+    Default = 'default',
+  }
+
   export interface SetDeviceMetricsOverrideRequest {
     /**
      * Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
@@ -7599,6 +7604,11 @@ export namespace Emulation {
      * the viewport meta tag is always enabled.
      */
     viewportMeta?: SetDeviceMetricsOverrideRequestViewportMeta;
+    /**
+     * Text layout mode. Default: `default`. Note: if `mobile` is `true`,
+     * mobile text layout mode (text autosizing) is always enabled.
+     */
+    textLayoutMode?: SetDeviceMetricsOverrideRequestTextLayoutMode;
   }
 
   export interface SetDevicePostureOverrideRequest {
@@ -17557,6 +17567,12 @@ export namespace Preload {
     key: PreloadingAttemptKey;
     pipelineId: PreloadPipelineId;
     status: PreloadingStatus;
+    /**
+     * The action currently performed by this attempt. This differs from
+     * `key.action` after a prerender-until-script attempt is upgraded in place
+     * to a full prerender.
+     */
+    effectiveAction?: SpeculationAction;
     prerenderStatus?: PrerenderFinalStatus;
     /**
      * This is used to give users more information about the name of Mojo interface

package/front_end/models/bindings/CompilerScriptMapping.ts

@@ -348,7 +348,7 @@ export class CompilerScriptMapping implements DebuggerSourceMapping {
       return false;
     }
     const {sourceMap, script} = sourceMapAndScript;
-    const {lineNumber, columnNumber} = script.relativeLocationToRawLocation(frame);
+    const {lineNumber, columnNumber} = script.rawLocationToRelativeLocation(frame);
 
     if (!sourceMap.isOutlinedFrame(lineNumber, columnNumber)) {
       const frames = sourceMap.translateCallSite(lineNumber, columnNumber);

package/front_end/models/formatter/FormatterWorkerPool.ts

@@ -5,7 +5,12 @@
 import * as Platform from '../../core/platform/platform.js';
 import * as FormatterActions from '../../entrypoints/formatter_actions/formatter_actions.js';
 
-export {DefinitionKind, ScopeKind, type ScopeTreeNode} from '../../entrypoints/formatter_actions/formatter_actions.js';
+export {
+  DefinitionKind,
+  ScopeKind,
+  type ScopeTreeNode,
+  type ScopeVariableMapping,
+} from '../../entrypoints/formatter_actions/formatter_actions.js';
 
 let formatterWorkerPoolInstance: FormatterWorkerPool|undefined;
 
@@ -134,8 +139,8 @@ export class FormatterWorkerPool {
     return this.runTask(FormatterActions.FormatterActions.FORMAT, parameters) as Promise<FormatterActions.FormatResult>;
   }
 
-  javaScriptSubstitute(expression: string, mapping: Array<Map<string, string|null>>): Promise<string> {
-    if (mapping.every(m => m.size === 0)) {
+  javaScriptSubstitute(expression: string, mapping: FormatterActions.ScopeVariableMapping[]): Promise<string> {
+    if (mapping.every(scope => scope.bindings.size === 0)) {
       return Promise.resolve(expression);
     }
     return this.runTask(FormatterActions.FormatterActions.JAVASCRIPT_SUBSTITUTE, {content: expression, mapping})

package/front_end/models/har/HARFormat.ts

@@ -2,6 +2,7 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+import * as Common from '../../core/common/common.js';
 import type * as Platform from '../../core/platform/platform.js';
 import * as SDK from '../../core/sdk/sdk.js';
 import type * as Protocol from '../../generated/protocol.js';
@@ -420,7 +421,9 @@ export class HARInitiator extends HARBase {
     super(data);
     this.type = (HARBase.optionalString(data['type']) ?? SDK.NetworkRequest.InitiatorType.OTHER) as
         Protocol.Network.InitiatorType;
-    this.url = HARBase.optionalString(data['url']);
+    const url = HARBase.optionalString(data['url']);
+    // Ignore privileged/non-web schemes in imported HARs.
+    this.url = url && Common.ParsedURL.hasWebSafeScheme(url) ? url : undefined;
     this.lineNumber = HARBase.optionalNumber(data['lineNumber']);
     this.requestId = HARBase.optionalString(data['requestId']) as Protocol.Network.RequestId;
     if (data['stack']) {
@@ -477,7 +480,9 @@ export class HARCallFrame extends HARBase {
 
     this.functionName = HARBase.optionalString(data['functionName']) ?? '';
     this.scriptId = (HARBase.optionalString(data['scriptId']) ?? '') as Protocol.Runtime.ScriptId;
-    this.url = HARBase.optionalString(data['url']) ?? '';
+    const url = HARBase.optionalString(data['url']) ?? '';
+    // Ignore privileged/non-web schemes in imported HARs.
+    this.url = Common.ParsedURL.hasWebSafeScheme(url) ? url : '';
     this.lineNumber = HARBase.optionalNumber(data['lineNumber']) ?? -1;
     this.columnNumber = HARBase.optionalNumber(data['columnNumber']) ?? -1;
   }