chrome-devtools-frontend 1.0.1696904 → 1.0.1697595

package/.geminiignore

@@ -2,5 +2,4 @@ node_modules/
 /third_party/
 front_end/core/i18n/locales/*.json
 front_end/third_party/lighthouse/locales/*.json
-front_end/third_party/puppeteer/package/lib/cjs/
 front_end/panels/timeline/fixtures/traces/

package/eslint.config.mjs

@@ -265,7 +265,8 @@ export default defineConfig([
         'error',
         {
           selector: 'ExportDefaultDeclaration',
-          message: 'Default exports are not allowed. Use named exports instead.',
+          message:
+            'Default exports are not allowed. Use named exports instead.',
         },
       ],
       /**
@@ -948,6 +949,8 @@ export default defineConfig([
       'eslint.config.mjs',
       '**/*/rollup.config.mjs',
       '**/*.rollup.js',
+      '**/*/karma.conf.ts',
+      '**/*/karma.conf.in.js',
     ],
     rules: {
       // The config operate on the default export

package/front_end/core/common/Base64.ts

@@ -32,14 +32,24 @@ export function decode(input: string): Uint8Array<ArrayBuffer> {
   return bytes;
 }
 
+export type BlobPart = ArrayBufferLike|Uint8Array|Blob|string;
+
 /**
  * Note: if input can be very large (larger than the max string size), callers should
  * expect this to throw an error.
  */
 export async function encode(input: BlobPart): Promise<string> {
+  const maybeFileReader = (globalThis as Record<string, unknown>)['FileReader'] as (new () => {
+                            onerror: (() => void) | null,
+                            onload: (() => void) | null,
+                            result: string | ArrayBuffer | null,
+                            readAsDataURL(blob: Blob): void,
+                          }) |
+      undefined;
+
   // Node.js environment (for foundation unit tests)
-  if (typeof FileReader === 'undefined') {
-    const blob = new Blob([input]);
+  if (!maybeFileReader) {
+    const blob = new Blob([input as unknown as (ArrayBuffer | Blob | string)]);
     const arrayBuffer = await blob.arrayBuffer();
     // Use globalThis.Buffer to avoid TypeScript errors if Node types are not included.
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -48,7 +58,7 @@ export async function encode(input: BlobPart): Promise<string> {
 
   // Browser environment
   return await new Promise((resolve, reject) => {
-    const reader = new FileReader();
+    const reader = new maybeFileReader();
     reader.onerror = () => reject(new Error('failed to convert to base64: internal error'));
     reader.onload = () => {
       // The input was too large to encode as a string. The caller should anticipate
@@ -71,6 +81,6 @@ export async function encode(input: BlobPart): Promise<string> {
       resolve(base64);
     };
 
-    reader.readAsDataURL(new Blob([input]));
+    reader.readAsDataURL(new Blob([input as unknown as (ArrayBuffer | Blob | string)]));
   });
 }

package/front_end/core/common/Color.ts

@@ -613,12 +613,15 @@ export function findFgColorForContrastAPCA(fgColor: Legacy, bgColor: Legacy, req
   const fgIsLighter = fgLuminance >= bgLuminance;
   const desiredLuminance = desiredLuminanceAPCA(bgLuminance, requiredContrast, fgIsLighter);
 
+  const meetsRequiredContrast = (candidate: Legacy): boolean =>
+      Math.round(Math.abs(contrastRatioAPCA(candidate.rgba(), bgColor.rgba()))) >= requiredContrast;
+
   const saturationComponentIndex = 1;
   const valueComponentIndex = 2;
 
   if (approachColorValue(candidateHSVA, valueComponentIndex, desiredLuminance, candidateLuminance)) {
     const candidate = Legacy.fromHSVA(candidateHSVA);
-    if (Math.abs(contrastRatioAPCA(bgColor.rgba(), candidate.rgba())) >= requiredContrast) {
+    if (meetsRequiredContrast(candidate)) {
       return candidate;
     }
   }
@@ -626,7 +629,7 @@ export function findFgColorForContrastAPCA(fgColor: Legacy, bgColor: Legacy, req
   candidateHSVA[valueComponentIndex] = 1;
   if (approachColorValue(candidateHSVA, saturationComponentIndex, desiredLuminance, candidateLuminance)) {
     const candidate = Legacy.fromHSVA(candidateHSVA);
-    if (Math.abs(contrastRatioAPCA(bgColor.rgba(), candidate.rgba())) >= requiredContrast) {
+    if (meetsRequiredContrast(candidate)) {
       return candidate;
     }
   }

package/front_end/core/common/Gzip.ts

@@ -19,7 +19,7 @@ export async function arrayBufferToString(ab: ArrayBufferLike): Promise<string>
   if (isGzip(ab)) {
     return await decompress(ab);
   }
-  const str = new TextDecoder('utf-8').decode(ab);
+  const str = new TextDecoder('utf-8').decode(new Uint8Array(ab));
   return str;
 }
 

package/front_end/core/common/Object.ts

@@ -128,7 +128,6 @@ export function eventMixin<
   Events,
   Base extends Platform.Constructor.Constructor<EventMixinBase>,
 >(base: Base): EventMixin<Events, Base> {
-  console.assert((base as unknown) !== HTMLElement);
   return class EventHandling extends base implements EventTarget<Events> {
     // Note that the weird name is due to TSC disallowing private/protected fields in
     // anonmous exported classes. We use a `__` prefix to prevent clashes with `base`.

package/front_end/core/host/InspectorFrontendHostAPI.ts

@@ -6,6 +6,11 @@ import type * as Platform from '../../core/platform/platform.js';
 import type * as Common from '../common/common.js';
 import type * as Root from '../root/root.js';
 
+declare global {
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  var InspectorFrontendHost: InspectorFrontendHostAPI;
+}
+
 /**
  * This values should match the one getting called from Chromium
  */
@@ -227,6 +232,14 @@ export interface FunctionCallEvent {
  * Please note that the "dispatch" side can't be type-checked as the dispatch is
  * done dynamically.
  **/
+export interface DevicesDiscoveryConfig {
+  discoverUsbDevices: boolean;
+  portForwardingEnabled: boolean;
+  portForwardingConfig: Record<string, string>;
+  networkDiscoveryEnabled: boolean;
+  networkDiscoveryConfig: string[];
+}
+
 export interface EventTypes {
   [Events.AppendedToURL]: Platform.DevToolsPath.RawPathString|Platform.DevToolsPath.UrlString;
   [Events.CanceledSaveURL]: Platform.DevToolsPath.UrlString;
@@ -234,7 +247,7 @@ export interface EventTypes {
   [Events.ContextMenuCleared]: void;
   [Events.ContextMenuItemSelected]: number;
   [Events.DeviceCountUpdated]: number;
-  [Events.DevicesDiscoveryConfigChanged]: Adb.Config;
+  [Events.DevicesDiscoveryConfigChanged]: DevicesDiscoveryConfig;
   [Events.DevicesPortForwardingStatusChanged]: void;
   [Events.DevicesUpdated]: void;
   [Events.DispatchMessage]: string;
@@ -399,7 +412,7 @@ export interface InspectorFrontendHostAPI {
 
   sendMessageToBackend(message: string): void;
 
-  setDevicesDiscoveryConfig(config: Adb.Config): void;
+  setDevicesDiscoveryConfig(config: DevicesDiscoveryConfig): void;
 
   setDevicesUpdatesEnabled(enabled: boolean): void;
 
@@ -423,7 +436,7 @@ export interface InspectorFrontendHostAPI {
 
   resetZoom(): void;
 
-  showContextMenuAtPoint(x: number, y: number, items: ContextMenuDescriptor[], document: Document): void;
+  showContextMenuAtPoint(x: number, y: number, items: ContextMenuDescriptor[], document: object): void;
 
   reattach(callback: () => void): void;
 

package/front_end/core/host/InspectorFrontendHostStub.ts

@@ -14,6 +14,7 @@ import {
   type ChangeEvent,
   type ClickEvent,
   type ContextMenuDescriptor,
+  type DevicesDiscoveryConfig,
   type DispatchHttpRequestRequest,
   type DispatchHttpRequestResult,
   type DoAidaConversationResult,
@@ -460,7 +461,7 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
   setOpenNewWindowForPopups(_value: boolean): void {
   }
 
-  setDevicesDiscoveryConfig(_config: Adb.Config): void {
+  setDevicesDiscoveryConfig(_config: DevicesDiscoveryConfig): void {
   }
 
   setDevicesUpdatesEnabled(_enabled: boolean): void {
@@ -472,7 +473,7 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
   openNodeFrontend(): void {
   }
 
-  showContextMenuAtPoint(_x: number, _y: number, _items: ContextMenuDescriptor[], _document: Document): void {
+  showContextMenuAtPoint(_x: number, _y: number, _items: ContextMenuDescriptor[], _document: object): void {
     throw new Error('Soft context menu should be used');
   }
 

package/front_end/core/host/ResourceLoader.ts

@@ -7,7 +7,6 @@
 import * as Common from '../common/common.js';
 import * as i18n from '../i18n/i18n.js';
 
-import {InspectorFrontendHostInstance} from './InspectorFrontendHost.js';
 import type {LoadNetworkResourceResult} from './InspectorFrontendHostAPI.js';
 
 const UIStrings = {
@@ -248,7 +247,7 @@ export const loadAsStream = function(
       rawHeaders.push(key + ': ' + headers[key]);
     }
   }
-  InspectorFrontendHostInstance.loadNetworkResource(url, rawHeaders.join('\r\n'), streamId, finishedCallback);
+  globalThis.InspectorFrontendHost.loadNetworkResource(url, rawHeaders.join('\r\n'), streamId, finishedCallback);
 
   function finishedCallback(response: LoadNetworkResourceResult): void {
     if (callback) {

package/front_end/core/platform/api/HostRuntime.ts

@@ -2,6 +2,17 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+export interface ScreenshotOptions {
+  base64Png: string;
+  fileName: string;
+  clip?: {
+    screenRectWidth: number,
+    screenRectHeight: number,
+    visiblePageRectLeft: number,
+    visiblePageRectTop: number,
+  };
+}
+
 /**
  * Provides abstractions for host features that require different implementations depending
  * on whether DevTools runs in the browser or Node.js
@@ -12,6 +23,10 @@ export interface HostRuntime {
   getOnLine(): boolean;
   getUserAgent(): string;
   getLocalStorage(): Storage|undefined;
+  getDevicePixelRatio(): number;
+  saveScreenshot(options: ScreenshotOptions): Promise<void>;
+  revokeLastScreenshotUrl(): void;
+  loadTextFile(url: URL): Promise<string>;
 }
 
 /**

package/front_end/core/platform/browser/HostRuntime.ts

@@ -69,6 +69,67 @@ class WebWorker implements Api.HostRuntime.Worker {
   }
 }
 
+let lastScreenshotBlobUrl: string|null = null;
+
+function revokeLastScreenshotUrl(): void {
+  if (lastScreenshotBlobUrl) {
+    URL.revokeObjectURL(lastScreenshotBlobUrl);
+    lastScreenshotBlobUrl = null;
+  }
+}
+
+async function saveScreenshot(options: Api.HostRuntime.ScreenshotOptions): Promise<void> {
+  const pageImage = new Image();
+  await new Promise<void>((resolve, reject) => {
+    pageImage.onload = () => resolve();
+    pageImage.onerror = () => reject(new Error('Failed to load image for screenshot'));
+    pageImage.src = 'data:image/png;base64,' + options.base64Png;
+  });
+
+  let canvas: OffscreenCanvas;
+  if (options.clip) {
+    const scale = pageImage.naturalWidth / options.clip.screenRectWidth;
+    const screenRectWidth = options.clip.screenRectWidth * scale;
+    const screenRectHeight = options.clip.screenRectHeight * scale;
+    const contentLeft = options.clip.visiblePageRectLeft * scale;
+    const contentTop = options.clip.visiblePageRectTop * scale;
+
+    canvas = new OffscreenCanvas(
+        Math.floor(screenRectWidth),
+        // Cap the height to not hit the GPU limit.
+        // https://crbug.com/1260828
+        Math.min(1 << 14, Math.floor(screenRectHeight)),
+    );
+    const ctx = canvas.getContext('2d', {willReadFrequently: true});
+    if (!ctx) {
+      throw new Error('Could not get 2d context from canvas.');
+    }
+    ctx.imageSmoothingEnabled = false;
+    ctx.drawImage(pageImage, Math.floor(contentLeft), Math.floor(contentTop));
+  } else {
+    canvas = new OffscreenCanvas(
+        pageImage.naturalWidth,
+        Math.min(1 << 14, Math.floor(pageImage.naturalHeight)),
+    );
+    const ctx = canvas.getContext('2d', {willReadFrequently: true});
+    if (!ctx) {
+      throw new Error('Could not get 2d context for base64 screenshot.');
+    }
+    ctx.imageSmoothingEnabled = false;
+    ctx.drawImage(pageImage, 0, 0);
+  }
+
+  revokeLastScreenshotUrl();
+  /* eslint-disable-next-line @devtools/no-imperative-dom-api */
+  const link = document.createElement('a');
+  link.download = options.fileName + '.png';
+  const blob = await canvas.convertToBlob({type: 'image/png'});
+  const blobUrl = URL.createObjectURL(blob);
+  lastScreenshotBlobUrl = blobUrl;
+  link.href = blobUrl;
+  link.click();
+}
+
 export const HOST_RUNTIME: Api.HostRuntime.HostRuntime = {
   createWorker(url: string): Api.HostRuntime.Worker {
     return new WebWorker(url);
@@ -84,4 +145,13 @@ export const HOST_RUNTIME: Api.HostRuntime.HostRuntime = {
       undefined {
         return 'localStorage' in globalThis ? globalThis.localStorage : undefined;
       },
+  getDevicePixelRatio(): number {
+    return window.devicePixelRatio;
+  },
+  saveScreenshot,
+  revokeLastScreenshotUrl,
+  async loadTextFile(url: URL): Promise<string> {
+    const response = await fetch(url);
+    return await response.text();
+  },
 };

package/front_end/core/platform/node/HostRuntime.ts

@@ -2,6 +2,8 @@
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
+import * as Fs from 'node:fs';
+import * as Url from 'node:url';
 import * as WorkerThreads from 'node:worker_threads';
 
 import type * as Api from '../api/api.js';
@@ -19,14 +21,16 @@ class NodeWorkerScope implements Api.HostRuntime.WorkerScope {
 }
 
 class NodeWorker implements Api.HostRuntime.Worker {
+  readonly #worker: WorkerThreads.Worker;
   readonly #workerPromise: Promise<WorkerThreads.Worker>;
   #disposed = false;
   #rejectWorkerPromise?: (error: Error) => void;
 
   constructor(url: string) {
-    this.#workerPromise = new Promise((resolve, reject) => {
+    const worker = new WorkerThreads.Worker(new URL(url));
+    this.#worker = worker;
+    this.#workerPromise = new Promise<WorkerThreads.Worker>((resolve, reject) => {
       this.#rejectWorkerPromise = reject;
-      const worker = new WorkerThreads.Worker(new URL(url));
       worker.once('message', (message: unknown) => {
         if (message === 'workerReady') {
           resolve(worker);
@@ -34,6 +38,8 @@ class NodeWorker implements Api.HostRuntime.Worker {
       });
       worker.on('error', reject);
     });
+    // Prevent unhandled promise rejections if the worker is terminated early.
+    this.#workerPromise.catch(() => {});
   }
 
   postMessage(message: unknown, transfer?: Api.HostRuntime.WorkerTransferable[]): void {
@@ -46,7 +52,7 @@ class NodeWorker implements Api.HostRuntime.Worker {
 
   dispose(): void {
     this.#disposed = true;
-    void this.#workerPromise.then(worker => worker.terminate());
+    void this.#worker.terminate();
   }
 
   terminate(immediately?: boolean): void {
@@ -92,4 +98,12 @@ export const HOST_RUNTIME: Api.HostRuntime.HostRuntime = {
       undefined {
         return undefined;
       },
+  getDevicePixelRatio(): number {
+    return 1;
+  },
+  async saveScreenshot(_options: Api.HostRuntime.ScreenshotOptions): Promise<void>{},
+  revokeLastScreenshotUrl(): void{},
+  async loadTextFile(url: URL): Promise<string> {
+    return await Fs.promises.readFile(Url.fileURLToPath(url), 'utf-8');
+  },
 };

package/front_end/core/root/Runtime.ts

@@ -545,6 +545,10 @@ interface DevToolsMobileSafeAreaEmulation {
   enabled: boolean;
 }
 
+interface DevToolsNetworkBackendLinking {
+  enabled: boolean;
+}
+
 /**
  * The host configuration that we expect from the DevTools back-end.
  *
@@ -602,6 +606,7 @@ export type HostConfig = Platform.TypeScriptUtilities.RecursivePartial<{
   devToolsAriaLiveRecording: DevToolsAriaLiveRecording,
   devToolsInstrumentationBreakpoints: DevToolsInstrumentationBreakpoints,
   devToolsMobileSafeAreaEmulation: DevToolsMobileSafeAreaEmulation,
+  devToolsNetworkBackendLinking: DevToolsNetworkBackendLinking,
   extensionsOnChromeUrls: ExtensionsOnChromeUrls,
   devToolsComments: HostConfigDevToolsComments,
 }>;

package/front_end/core/sdk/CSSStyleSheetHeader.ts

@@ -19,11 +19,11 @@ const UIStrings = {
   /**
    * @description Error message for when a CSS file can't be loaded.
    */
-  couldNotFindTheOriginalStyle: 'Could not find the original style sheet.',
+  couldNotFindTheOriginalStyle: 'Could not find the original style sheet',
   /**
    * @description Error message to display when a source CSS file could not be retrieved.
    */
-  couldNotRetrieveSourceStyles: 'Could not retrieve source styles.',
+  couldNotRetrieveSourceStyles: 'Could not retrieve source styles',
 } as const;
 const str_ = i18n.i18n.registerUIStrings('core/sdk/CSSStyleSheetHeader.ts', UIStrings);
 const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);

package/front_end/core/sdk/ConsoleModel.ts

@@ -56,16 +56,16 @@ const UIStrings = {
    * @description Text shown in the console when a performance profile (with the given name) was started.
    * @example {title} PH1
    */
-  profileSStarted: 'Profile \'\'{PH1}\'\' started.',
+  profileSStarted: 'Profile \'\'{PH1}\'\' started',
   /**
    * @description Text shown in the console when a performance profile (with the given name) was stopped.
    * @example {name} PH1
    */
-  profileSFinished: 'Profile \'\'{PH1}\'\' finished.',
+  profileSFinished: 'Profile \'\'{PH1}\'\' finished',
   /**
    * @description Error message shown in the console after the user tries to save a JavaScript value to a temporary variable.
    */
-  failedToSaveToTempVariable: 'Failed to save to temp variable.',
+  failedToSaveToTempVariable: 'Failed to save to temp variable',
 } as const;
 
 const str_ = i18n.i18n.registerUIStrings('core/sdk/ConsoleModel.ts', UIStrings);

package/front_end/core/sdk/DOMModel.ts

@@ -1427,6 +1427,19 @@ export class DOMNode extends Common.ObjectWrapper.ObjectWrapper<DOMNodeEventType
     return this.domModel().nodeForId(response.nodeId);
   }
 
+  async getImplicitAnchorCandidates(): Promise<DeferredDOMNode[]> {
+    const response = await this.#agent.invoke_getImplicitAnchorCandidates({
+      nodeId: this.id,
+    });
+
+    if (response.getError() || !response.backendNodeIds) {
+      return [];
+    }
+
+    const target = this.domModel().target();
+    return response.backendNodeIds.map(backendNodeId => new DeferredDOMNode(target, backendNodeId));
+  }
+
   async takeSnapshot(ownerDocumentSnapshot?: DOMDocument): Promise<DOMNode> {
     const snapshot = (this instanceof DOMDocument) ? new DOMDocumentSnapshot(this.domModel(), {
       nodeId: this.id,

package/front_end/core/sdk/DebuggerModel.ts

@@ -1331,6 +1331,7 @@ export class CallFrame {
       generatePreview: options.generatePreview,
       throwOnSideEffect: options.throwOnSideEffect,
       timeout: options.timeout,
+      scopeNumber: options.scopeNumber,
     });
     const error = response.getError();
     if (error) {
@@ -1407,6 +1408,11 @@ export class Scope implements ScopeChainEntry {
     return this.#callFrame;
   }
 
+  /** The index of this scope in {@link CallFrame.scopeChain}, usable as an `evaluateOnCallFrame` `scopeNumber`. */
+  ordinal(): number {
+    return this.#ordinal;
+  }
+
   type(): string {
     return this.#type;
   }

package/front_end/core/sdk/NetworkRequest.ts

@@ -30,15 +30,15 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  secureOnly: 'This cookie was blocked because it had the "`Secure`" attribute and the connection was not secure.',
+  secureOnly: 'This cookie was blocked because it had the "`Secure`" attribute and the connection was not secure',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  notOnPath: 'This cookie was blocked because its path was not an exact match for or a superdirectory of the request URL’s path.',
+  notOnPath: 'This cookie was blocked because its path was not an exact match for or a superdirectory of the request URL’s path',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  domainMismatch: 'This cookie was blocked because neither did the request URL’s domain exactly match the cookie’s domain, nor was the request URL’s domain a subdomain of the cookie’s Domain attribute value.',
+  domainMismatch: 'This cookie was blocked because neither did the request URL’s domain exactly match the cookie’s domain, nor was the request URL’s domain a subdomain of the cookie’s Domain attribute value',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
@@ -46,7 +46,7 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  sameSiteLax: 'This cookie was blocked because it had the "`SameSite=Lax`" attribute and the request was made from a different site and was not initiated by a top-level navigation.',
+  sameSiteLax: 'This cookie was blocked because it had the "`SameSite=Lax`" attribute and the request was made from a different site and was not initiated by a top-level navigation',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
@@ -58,7 +58,7 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  userPreferences: 'This cookie was blocked due to user preferences.',
+  userPreferences: 'This cookie was blocked due to user preferences',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
@@ -66,7 +66,7 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  unknownError: 'An unknown error was encountered when trying to send this cookie.',
+  unknownError: 'An unknown error was encountered when trying to send this cookie',
   /**
    * @description Tooltip to explain why a cookie was blocked due to exceeding the maximum size.
    */
@@ -74,7 +74,7 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why an attempt to set a cookie via `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  thisSetcookieWasBlockedDueToUser: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked due to user preferences.',
+  thisSetcookieWasBlockedDueToUser: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked due to user preferences',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via `Set-Cookie` HTTP header on a request's response was blocked.
    */
@@ -82,28 +82,28 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why an attempt to set a cookie via `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  thisSetcookieHadInvalidSyntax: 'This "`Set-Cookie`" header had invalid syntax.',
+  thisSetcookieHadInvalidSyntax: 'This "`Set-Cookie`" header had invalid syntax',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  thisSetcookieHadADisallowedCharacter: 'This "`Set-Cookie`" header contained a disallowed character (a forbidden ASCII control character, or the tab character if it appears in the middle of the cookie name, value, an attribute name, or an attribute value).',
+  thisSetcookieHadADisallowedCharacter: 'This "`Set-Cookie`" header contained a disallowed character (a forbidden ASCII control character, or the tab character if it appears in the middle of the cookie name, value, an attribute name, or an attribute value)',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  theSchemeOfThisConnectionIsNot: 'The scheme of this connection is not allowed to store cookies.',
+  theSchemeOfThisConnectionIsNot: 'The scheme of this connection is not allowed to store cookies',
   /**
    * @description Tooltip to explain why a cookie was blocked.
    */
-  anUnknownErrorWasEncounteredWhenTrying: 'An unknown error was encountered when trying to store this cookie.',
+  anUnknownErrorWasEncounteredWhenTrying: 'An unknown error was encountered when trying to store this cookie',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  blockedReasonSecureOnly: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it had the "`Secure`" attribute but was not received over a secure connection.',
+  blockedReasonSecureOnly: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it had the "`Secure`" attribute but was not received over a secure connection',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    * @example {SameSite=Strict} PH1
    */
-  blockedReasonSameSiteStrictLax: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it had the "{PH1}" attribute but came from a cross-site response which was not the response to a top-level navigation.',
+  blockedReasonSameSiteStrictLax: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it had the "{PH1}" attribute but came from a cross-site response which was not the response to a top-level navigation',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    */
@@ -111,19 +111,19 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  blockedReasonSameSiteNoneInsecure: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it had the "`SameSite=None`" attribute but did not have the "`Secure`" attribute, which is required in order to use "`SameSite=None`".',
+  blockedReasonSameSiteNoneInsecure: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it had the "`SameSite=None`" attribute but did not have the "`Secure`" attribute, which is required in order to use "`SameSite=None`"',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  blockedReasonOverwriteSecure: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it was not sent over a secure connection and would have overwritten a cookie with the "`Secure`" attribute.',
+  blockedReasonOverwriteSecure: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it was not sent over a secure connection and would have overwritten a cookie with the "`Secure`" attribute',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  blockedReasonInvalidDomain: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because its "`Domain`" attribute was invalid with regards to the current host URL.',
+  blockedReasonInvalidDomain: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because its "`Domain`" attribute was invalid with regards to the current host URL',
   /**
    * @description Tooltip to explain why an attempt to set a cookie via a `Set-Cookie` HTTP header on a request's response was blocked.
    */
-  blockedReasonInvalidPrefix: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it used the "`__Secure-`" or "`__Host-`" prefix in its name and broke the additional rules applied to cookies with these prefixes as defined in `https://tools.ietf.org/html/draft-west-cookie-prefixes-05`.',
+  blockedReasonInvalidPrefix: 'This attempt to set a cookie via a "`Set-Cookie`" header was blocked because it used the "`__Secure-`" or "`__Host-`" prefix in its name and broke the additional rules applied to cookies with these prefixes as defined in `https://tools.ietf.org/html/draft-west-cookie-prefixes-05`',
   /**
    * @description Tooltip to explain why a cookie was blocked when the size of the #name plus the size of the value exceeds the max size.
    */
@@ -136,7 +136,7 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why the cookie should have been blocked by third-party cookie phaseout but is exempted.
    */
-  exemptionReasonUserSetting: 'This cookie is allowed by user preference.',
+  exemptionReasonUserSetting: 'This cookie is allowed by user preference',
   /**
    * @description Tooltip to explain why the cookie should have been blocked by third-party cookie phaseout but is exempted.
    */
@@ -152,7 +152,7 @@ const UIStrings = {
   /**
    * @description Tooltip to explain why the cookie should have been blocked by third-party cookie phaseout but is exempted.
    */
-  exemptionReasonScheme: 'This cookie is allowed by the top-level URL scheme.',
+  exemptionReasonScheme: 'This cookie is allowed by the top-level URL scheme',
 } as const;
 // clang-format on
 

package/front_end/core/sdk/RuntimeModel.ts

@@ -718,6 +718,11 @@ export interface EvaluationOptions {
   replMode?: boolean;
   allowUnsafeEvalBlockedByCSP?: boolean;
   contextId?: number;
+  /**
+   * Index into `CallFrame.scopeChain()` denoting the scope in which the expression is evaluated.
+   * Defaults to 0, i.e. the inner-most scope. Only honored by `CallFrame.evaluate`.
+   */
+  scopeNumber?: number;
 }
 
 export interface CallFunctionOptions {

package/front_end/core/sdk/Script.ts

@@ -50,11 +50,11 @@ const UIStrings = {
   /**
    * @description Error message for when a script can't be loaded because it was removed or deleted.
    */
-  scriptRemovedOrDeleted: 'Script removed or deleted.',
+  scriptRemovedOrDeleted: 'Script removed or deleted',
   /**
    * @description Error message when failing to load a script source text.
    */
-  unableToFetchScriptSource: 'Unable to fetch script source.',
+  unableToFetchScriptSource: 'Unable to fetch script source',
 } as const;
 const str_ = i18n.i18n.registerUIStrings('core/sdk/Script.ts', UIStrings);
 const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);