chrome-devtools-frontend 1.0.1665921 → 1.0.1667564

package/front_end/models/ai_assistance/contexts/PerformanceTraceContext.ts

@@ -7,6 +7,7 @@ import type {UrlString} from '../../../core/platform/DevToolsPath.js';
 import type * as Platform from '../../../core/platform/platform.js';
 import * as SDK from '../../../core/sdk/sdk.js';
 import * as Tracing from '../../../services/tracing/tracing.js';
+import * as Bindings from '../../bindings/bindings.js';
 import * as SourceMapScopes from '../../source_map_scopes/source_map_scopes.js';
 import * as Trace from '../../trace/trace.js';
 import {
@@ -28,52 +29,63 @@ import {AgentFocus} from '../performance/AIContext.js';
  * the context data for the LLM prompt and user-facing accordion disclosures.
  */
 export class PerformanceTraceContext extends ConversationContext<AgentFocus> {
-  static fromParsedTrace(parsedTrace: Trace.TraceModel.ParsedTrace,
-                         targetManager: SDK.TargetManager.TargetManager = SDK.TargetManager.TargetManager.instance(),
-                         freshRecordingTracker:
-                             Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance()):
-      PerformanceTraceContext {
+  static fromParsedTrace(
+      parsedTrace: Trace.TraceModel.ParsedTrace,
+      targetManager: SDK.TargetManager.TargetManager = SDK.TargetManager.TargetManager.instance(),
+      freshRecordingTracker: Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance(),
+      debuggerWorkspaceBinding: Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding =
+          Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding.instance()): PerformanceTraceContext {
     return new PerformanceTraceContext(
         AgentFocus.fromParsedTrace(parsedTrace),
         targetManager,
         freshRecordingTracker,
+        debuggerWorkspaceBinding,
     );
   }
 
   static fromInsight(parsedTrace: Trace.TraceModel.ParsedTrace, insight: Trace.Insights.Types.InsightModel,
                      targetManager: SDK.TargetManager.TargetManager = SDK.TargetManager.TargetManager.instance(),
-                     freshRecordingTracker: Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance()):
+                     freshRecordingTracker: Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance(),
+                     debuggerWorkspaceBinding: Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding =
+                         Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding.instance()):
       PerformanceTraceContext {
     return new PerformanceTraceContext(
         AgentFocus.fromInsight(parsedTrace, insight),
         targetManager,
         freshRecordingTracker,
+        debuggerWorkspaceBinding,
     );
   }
 
   static fromCallTree(callTree: AICallTree,
                       targetManager: SDK.TargetManager.TargetManager = SDK.TargetManager.TargetManager.instance(),
-                      freshRecordingTracker:
-                          Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance()):
+                      freshRecordingTracker: Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance(),
+                      debuggerWorkspaceBinding: Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding =
+                          Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding.instance()):
       PerformanceTraceContext {
     return new PerformanceTraceContext(
         AgentFocus.fromCallTree(callTree),
         targetManager,
         freshRecordingTracker,
+        debuggerWorkspaceBinding,
     );
   }
 
   readonly #focus: AgentFocus;
   readonly #targetManager: SDK.TargetManager.TargetManager;
   readonly #freshRecordingTracker: Tracing.FreshRecording.Tracker;
+  readonly #debuggerWorkspaceBinding: Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding;
 
   constructor(focus: AgentFocus,
               targetManager: SDK.TargetManager.TargetManager = SDK.TargetManager.TargetManager.instance(),
-              freshRecordingTracker: Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance()) {
+              freshRecordingTracker: Tracing.FreshRecording.Tracker = Tracing.FreshRecording.Tracker.instance(),
+              debuggerWorkspaceBinding: Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding =
+                  Bindings.DebuggerWorkspaceBinding.DebuggerWorkspaceBinding.instance()) {
     super();
     this.#focus = focus;
     this.#targetManager = targetManager;
     this.#freshRecordingTracker = freshRecordingTracker;
+    this.#debuggerWorkspaceBinding = debuggerWorkspaceBinding;
   }
 
   /**
@@ -95,7 +107,8 @@ export class PerformanceTraceContext extends ConversationContext<AgentFocus> {
         return null;
       }
       return await SourceMapScopes.FunctionCodeResolver.getFunctionCodeFromLocation(
-          target, url, line, column, {contextLength: 200, contextLineLength: 5, appendProfileData: true});
+          target, url, line, column, this.#debuggerWorkspaceBinding,
+          {contextLength: 200, contextLineLength: 5, appendProfileData: true});
     };
     return formatter;
   }

package/front_end/models/ai_assistance/data_formatters/PerformanceTraceFormatter.ts

@@ -39,19 +39,29 @@ export class PerformanceTraceFormatter {
       (url: Platform.DevToolsPath.UrlString, line: number,
        column: number) => Promise<SourceMapScopes.FunctionCodeResolver.FunctionCode|null>;
 
-  readonly #cruxManager: CrUXManager.CrUXManager;
+  readonly #cruxManager: CrUXManager.CrUXManager|null;
 
   constructor(
       focus: AgentFocus,
       deviceScope: CrUXManager.DeviceScope|null = null,
-      cruxManager: CrUXManager.CrUXManager = CrUXManager.CrUXManager.instance(),
+      cruxManager?: CrUXManager.CrUXManager,
   ) {
     this.#focus = focus;
     this.#parsedTrace = focus.parsedTrace;
     this.#insightSet = focus.primaryInsightSet;
     this.#eventsSerializer = focus.eventsSerializer;
     this.#deviceScope = deviceScope;
-    this.#cruxManager = cruxManager;
+    if (cruxManager) {
+      this.#cruxManager = cruxManager;
+    } else {
+      // In environments outside DevTools (like the MCP server or some tests),
+      // CrUXManager.instance() can fail due to uninitialized global settings/storage.
+      try {
+        this.#cruxManager = CrUXManager.CrUXManager.instance();
+      } catch {
+        this.#cruxManager = null;
+      }
+    }
   }
 
   serializeEvent(event: Trace.Types.Events.Event): string {
@@ -72,8 +82,14 @@ export class PerformanceTraceFormatter {
       return [];
     }
     try {
-      const cruxScope: CrUXManager.Scope =
-          this.#deviceScope ? {pageScope: 'url', deviceScope: this.#deviceScope} : this.#cruxManager.getSelectedScope();
+      let cruxScope: CrUXManager.Scope;
+      if (this.#deviceScope) {
+        cruxScope = {pageScope: 'url', deviceScope: this.#deviceScope};
+      } else if (this.#cruxManager) {
+        cruxScope = this.#cruxManager.getSelectedScope();
+      } else {
+        return [];
+      }
       const parts: string[] = [];
       const fieldMetrics =
           Trace.Insights.Common.getFieldMetricsForInsightSet(insightSet, this.#parsedTrace.metadata, cruxScope);

package/front_end/models/computed_style/ComputedStyleModel.ts

@@ -15,7 +15,7 @@ export class ComputedStyleModel extends Common.ObjectWrapper.ObjectWrapper<Event
   #node: SDK.DOMModel.DOMNode|null = null;
   #cssModel: SDK.CSSModel.CSSModel|null = null;
   private eventListeners: Common.EventTarget.EventDescriptor[] = [];
-  private frameResizedTimer?: number;
+  private frameResizedTimer?: ReturnType<typeof setTimeout>;
   private computedStylePromise?: Promise<ComputedStyle|null>;
 
   constructor(node?: SDK.DOMModel.DOMNode|null) {
@@ -49,10 +49,9 @@ export class ComputedStyleModel extends Common.ObjectWrapper.ObjectWrapper<Event
     this.node = null;
     this.#cssModel = null;
     this.computedStylePromise = undefined;
-    if (this.frameResizedTimer) {
+
       clearTimeout(this.frameResizedTimer);
       this.frameResizedTimer = undefined;
-    }
   }
 
   private updateModel(cssModel: SDK.CSSModel.CSSModel|null): void {
@@ -111,14 +110,12 @@ export class ComputedStyleModel extends Common.ObjectWrapper.ObjectWrapper<Event
   private onFrameResized(): void {
     function refreshContents(this: ComputedStyleModel): void {
       this.onCSSModelChanged(null);
-      delete this.frameResizedTimer;
+      this.frameResizedTimer = undefined;
     }
 
-    if (this.frameResizedTimer) {
       clearTimeout(this.frameResizedTimer);
-    }
 
-    this.frameResizedTimer = window.setTimeout(refreshContents.bind(this), 100);
+      this.frameResizedTimer = globalThis.setTimeout(refreshContents.bind(this), 100);
   }
 
   private elementNode(): SDK.DOMModel.DOMNode|null {

package/front_end/models/crux-manager/CrUXManager.ts

@@ -311,6 +311,10 @@ export class CrUXManager extends Common.ObjectWrapper.ObjectWrapper<EventTypes>
     this.dispatchEventToListeners(Events.FIELD_DATA_CHANGED, this.#pageResult);
   }
 
+  setMainDocumentURL(url: string): void {
+    this.#mainDocumentUrl = url;
+  }
+
   #normalizeUrl(inputUrl: string): URL {
     const normalizedUrl = new URL(inputUrl);
     normalizedUrl.hash = '';

package/front_end/models/extensions/ExtensionAPI.ts

@@ -1554,7 +1554,7 @@ self.injectedExtensionAPI = function(
   }
 
   let keyboardEventRequestQueue: KeyboardEventInit&Array<{eventType: string}> = [];
-  let forwardTimer: number|null = null;
+  let forwardTimer: ReturnType<typeof setTimeout>|undefined;
   function forwardKeyboardEvent(event: KeyboardEvent): void {
     // Check if the event should be forwarded.
     // This is a workaround for crbug.com/923338.
@@ -1601,12 +1601,12 @@ self.injectedExtensionAPI = function(
     };
     keyboardEventRequestQueue.push(requestPayload);
     if (!forwardTimer) {
-      forwardTimer = window.setTimeout(forwardEventQueue, 0);
+      forwardTimer = globalThis.setTimeout(forwardEventQueue, 0);
     }
   }
 
   function forwardEventQueue(): void {
-    forwardTimer = null;
+    forwardTimer = undefined;
     extensionServer.sendRequest(
         {command: PrivateAPI.Commands.ForwardKeyboardEvent, entries: keyboardEventRequestQueue});
     keyboardEventRequestQueue = [];

package/front_end/models/heap_snapshot/HeapSnapshotProxy.ts

@@ -17,7 +17,7 @@ export class HeapSnapshotWorkerProxy extends Common.ObjectWrapper.ObjectWrapper<
   callbacks = new Map<number, (...args: any[]) => void>();
   readonly previousCallbacks = new Set<number>();
   readonly worker: PlatformApi.HostRuntime.Worker;
-  interval?: number;
+  interval?: ReturnType<typeof setInterval>;
   readonly workerUrl?: string;
 
   constructor(
@@ -129,7 +129,7 @@ export class HeapSnapshotWorkerProxy extends Common.ObjectWrapper.ObjectWrapper<
       return;
     }
     this.checkLongRunningCalls();
-    this.interval = window.setInterval(this.checkLongRunningCalls.bind(this), 300);
+    this.interval = globalThis.setInterval(this.checkLongRunningCalls.bind(this), 300);
   }
 
   checkLongRunningCalls(): void {

package/front_end/models/issues_manager/CookieIssue.ts

@@ -21,10 +21,6 @@ const UIStrings = {
    * @description Label for the link for SameSite cookie issues.
    */
   samesiteCookiesExplained: 'SameSite cookies explained',
-  /**
-   * @description Label for the link for Schemeful Same-Site issues.
-   */
-  howSchemefulSamesiteWorks: 'How Schemeful Same-Site works',
   /**
    * @description Label for a link for cross-site redirect issues.
    */
@@ -92,9 +88,8 @@ export class CookieIssue extends Issue<Protocol.Audits.CookieIssueDetails> {
     // Some exclusion reasons are dependent on warning reasons existing in order to produce an issue.
     if (cookieIssueDetails.cookieExclusionReasons && cookieIssueDetails.cookieExclusionReasons.length > 0) {
       for (const exclusionReason of cookieIssueDetails.cookieExclusionReasons) {
-        const code = CookieIssue.codeForCookieIssueDetails(
-            exclusionReason, cookieIssueDetails.cookieWarningReasons, cookieIssueDetails.operation,
-            cookieIssueDetails.cookieUrl as Platform.DevToolsPath.UrlString | undefined);
+        const code = CookieIssue.codeForCookieIssueDetails(exclusionReason, cookieIssueDetails.cookieWarningReasons,
+                                                           cookieIssueDetails.operation);
         if (code) {
           issues.push(new CookieIssue(code, cookieIssueDetails, issuesModel, issueId, frameManager));
         }
@@ -105,9 +100,7 @@ export class CookieIssue extends Issue<Protocol.Audits.CookieIssueDetails> {
     if (cookieIssueDetails.cookieWarningReasons) {
       for (const warningReason of cookieIssueDetails.cookieWarningReasons) {
         // warningReasons should be an empty array here.
-        const code = CookieIssue.codeForCookieIssueDetails(
-            warningReason, [], cookieIssueDetails.operation,
-            cookieIssueDetails.cookieUrl as Platform.DevToolsPath.UrlString | undefined);
+        const code = CookieIssue.codeForCookieIssueDetails(warningReason, [], cookieIssueDetails.operation);
         if (code) {
           issues.push(new CookieIssue(code, cookieIssueDetails, issuesModel, issueId, frameManager));
         }
@@ -124,39 +117,12 @@ export class CookieIssue extends Issue<Protocol.Audits.CookieIssueDetails> {
    *
    * The issue code will be mapped to a CookieIssueSubCategory enum for metric purpose.
    */
-  static codeForCookieIssueDetails(
-      reason: Protocol.Audits.CookieExclusionReason|Protocol.Audits.CookieWarningReason,
-      warningReasons: Protocol.Audits.CookieWarningReason[], operation: Protocol.Audits.CookieOperation,
-      cookieUrl?: Platform.DevToolsPath.UrlString): string|null {
-    const isURLSecure =
-        cookieUrl && (Common.ParsedURL.schemeIs(cookieUrl, 'https:') || Common.ParsedURL.schemeIs(cookieUrl, 'wss:'));
-    const secure = isURLSecure ? 'Secure' : 'Insecure';
-
+  static codeForCookieIssueDetails(reason: Protocol.Audits.CookieExclusionReason|Protocol.Audits.CookieWarningReason,
+                                   warningReasons: Protocol.Audits.CookieWarningReason[],
+                                   operation: Protocol.Audits.CookieOperation): string|null {
     if (reason === Protocol.Audits.CookieExclusionReason.ExcludeSameSiteStrict ||
         reason === Protocol.Audits.CookieExclusionReason.ExcludeSameSiteLax ||
         reason === Protocol.Audits.CookieExclusionReason.ExcludeSameSiteUnspecifiedTreatedAsLax) {
-      if (warningReasons && warningReasons.length > 0) {
-        if (warningReasons.includes(Protocol.Audits.CookieWarningReason.WarnSameSiteStrictLaxDowngradeStrict)) {
-          return [
-            Protocol.Audits.InspectorIssueCode.CookieIssue,
-            'ExcludeNavigationContextDowngrade',
-            secure,
-          ].join('::');
-        }
-
-        if (warningReasons.includes(Protocol.Audits.CookieWarningReason.WarnSameSiteStrictCrossDowngradeStrict) ||
-            warningReasons.includes(Protocol.Audits.CookieWarningReason.WarnSameSiteStrictCrossDowngradeLax) ||
-            warningReasons.includes(Protocol.Audits.CookieWarningReason.WarnSameSiteLaxCrossDowngradeStrict) ||
-            warningReasons.includes(Protocol.Audits.CookieWarningReason.WarnSameSiteLaxCrossDowngradeLax)) {
-          return [
-            Protocol.Audits.InspectorIssueCode.CookieIssue,
-            'ExcludeContextDowngrade',
-            operation,
-            secure,
-          ].join('::');
-        }
-      }
-
       if (warningReasons.includes(Protocol.Audits.CookieWarningReason.WarnCrossSiteRedirectDowngradeChangesInclusion)) {
         return [
           Protocol.Audits.InspectorIssueCode.CookieIssue,
@@ -175,17 +141,6 @@ export class CookieIssue extends Issue<Protocol.Audits.CookieIssueDetails> {
       return null;
     }
 
-    if (reason === Protocol.Audits.CookieWarningReason.WarnSameSiteStrictLaxDowngradeStrict) {
-      return [Protocol.Audits.InspectorIssueCode.CookieIssue, reason, secure].join('::');
-    }
-    // These have the same message.
-    if (reason === Protocol.Audits.CookieWarningReason.WarnSameSiteStrictCrossDowngradeStrict ||
-        reason === Protocol.Audits.CookieWarningReason.WarnSameSiteStrictCrossDowngradeLax ||
-        reason === Protocol.Audits.CookieWarningReason.WarnSameSiteLaxCrossDowngradeLax ||
-        reason === Protocol.Audits.CookieWarningReason.WarnSameSiteLaxCrossDowngradeStrict) {
-      return [Protocol.Audits.InspectorIssueCode.CookieIssue, 'WarnCrossDowngrade', operation, secure].join('::');
-    }
-
     if (reason === Protocol.Audits.CookieExclusionReason.ExcludePortMismatch) {
       return [Protocol.Audits.InspectorIssueCode.CookieIssue, 'ExcludePortMismatch'].join('::');
     }
@@ -433,67 +388,6 @@ const sameSiteNoneInsecureWarnSet: LazyMarkdownIssueDescription = {
   ],
 };
 
-const schemefulSameSiteArticles =
-    [{link: 'https://web.dev/schemeful-samesite/', linkTitle: i18nLazyString(UIStrings.howSchemefulSamesiteWorks)}];
-
-function schemefulSameSiteSubstitutions(
-    {isDestinationSecure, isOriginSecure}: {isDestinationSecure: boolean, isOriginSecure: boolean}):
-    Map<string, () => string> {
-  return new Map([
-    // TODO(crbug.com/1168438): Use translated phrases once the issue description is localized.
-    ['PLACEHOLDER_destination', () => isDestinationSecure ? 'a secure' : 'an insecure'],
-    ['PLACEHOLDER_origin', () => isOriginSecure ? 'a secure' : 'an insecure'],
-  ]);
-}
-
-function sameSiteWarnStrictLaxDowngradeStrict(isSecure: boolean): LazyMarkdownIssueDescription {
-  return {
-    file: 'SameSiteWarnStrictLaxDowngradeStrict.md',
-    substitutions: schemefulSameSiteSubstitutions({isDestinationSecure: isSecure, isOriginSecure: !isSecure}),
-    links: schemefulSameSiteArticles,
-  };
-}
-
-function sameSiteExcludeNavigationContextDowngrade(isSecure: boolean): LazyMarkdownIssueDescription {
-  return {
-    file: 'SameSiteExcludeNavigationContextDowngrade.md',
-    substitutions: schemefulSameSiteSubstitutions({isDestinationSecure: isSecure, isOriginSecure: !isSecure}),
-    links: schemefulSameSiteArticles,
-  };
-}
-
-function sameSiteWarnCrossDowngradeRead(isSecure: boolean): LazyMarkdownIssueDescription {
-  return {
-    file: 'SameSiteWarnCrossDowngradeRead.md',
-    substitutions: schemefulSameSiteSubstitutions({isDestinationSecure: isSecure, isOriginSecure: !isSecure}),
-    links: schemefulSameSiteArticles,
-  };
-}
-
-function sameSiteExcludeContextDowngradeRead(isSecure: boolean): LazyMarkdownIssueDescription {
-  return {
-    file: 'SameSiteExcludeContextDowngradeRead.md',
-    substitutions: schemefulSameSiteSubstitutions({isDestinationSecure: isSecure, isOriginSecure: !isSecure}),
-    links: schemefulSameSiteArticles,
-  };
-}
-
-function sameSiteWarnCrossDowngradeSet(isSecure: boolean): LazyMarkdownIssueDescription {
-  return {
-    file: 'SameSiteWarnCrossDowngradeSet.md',
-    substitutions: schemefulSameSiteSubstitutions({isDestinationSecure: !isSecure, isOriginSecure: isSecure}),
-    links: schemefulSameSiteArticles,
-  };
-}
-
-function sameSiteExcludeContextDowngradeSet(isSecure: boolean): LazyMarkdownIssueDescription {
-  return {
-    file: 'SameSiteExcludeContextDowngradeSet.md',
-    substitutions: schemefulSameSiteSubstitutions({isDestinationSecure: isSecure, isOriginSecure: !isSecure}),
-    links: schemefulSameSiteArticles,
-  };
-}
-
 const attributeValueExceedsMaxSize: LazyMarkdownIssueDescription = {
   file: 'CookieAttributeValueExceedsMaxSize.md',
   links: [],
@@ -551,21 +445,6 @@ const issueDescriptions = new Map<string, LazyMarkdownIssueDescription>([
   ['CookieIssue::ExcludeSameSiteNoneInsecure::SetCookie', sameSiteNoneInsecureErrorSet],
   ['CookieIssue::WarnSameSiteNoneInsecure::ReadCookie', sameSiteNoneInsecureWarnRead],
   ['CookieIssue::WarnSameSiteNoneInsecure::SetCookie', sameSiteNoneInsecureWarnSet],
-  ['CookieIssue::WarnSameSiteStrictLaxDowngradeStrict::Secure', sameSiteWarnStrictLaxDowngradeStrict(true)],
-  ['CookieIssue::WarnSameSiteStrictLaxDowngradeStrict::Insecure', sameSiteWarnStrictLaxDowngradeStrict(false)],
-  ['CookieIssue::WarnCrossDowngrade::ReadCookie::Secure', sameSiteWarnCrossDowngradeRead(true)],
-  ['CookieIssue::WarnCrossDowngrade::ReadCookie::Insecure', sameSiteWarnCrossDowngradeRead(false)],
-  ['CookieIssue::WarnCrossDowngrade::SetCookie::Secure', sameSiteWarnCrossDowngradeSet(true)],
-  ['CookieIssue::WarnCrossDowngrade::SetCookie::Insecure', sameSiteWarnCrossDowngradeSet(false)],
-  ['CookieIssue::ExcludeNavigationContextDowngrade::Secure', sameSiteExcludeNavigationContextDowngrade(true)],
-  [
-    'CookieIssue::ExcludeNavigationContextDowngrade::Insecure',
-    sameSiteExcludeNavigationContextDowngrade(false),
-  ],
-  ['CookieIssue::ExcludeContextDowngrade::ReadCookie::Secure', sameSiteExcludeContextDowngradeRead(true)],
-  ['CookieIssue::ExcludeContextDowngrade::ReadCookie::Insecure', sameSiteExcludeContextDowngradeRead(false)],
-  ['CookieIssue::ExcludeContextDowngrade::SetCookie::Secure', sameSiteExcludeContextDowngradeSet(true)],
-  ['CookieIssue::ExcludeContextDowngrade::SetCookie::Insecure', sameSiteExcludeContextDowngradeSet(false)],
   ['CookieIssue::WarnAttributeValueExceedsMaxSize::ReadCookie', attributeValueExceedsMaxSize],
   ['CookieIssue::WarnAttributeValueExceedsMaxSize::SetCookie', attributeValueExceedsMaxSize],
   ['CookieIssue::WarnDomainNonASCII::ReadCookie', warnDomainNonAscii],

package/front_end/models/issues_manager/descriptions/CoepCorpNotSameOrigin.md

@@ -1,7 +1,7 @@
-# Specify a more permissive Cross-Origin Resource Policy to prevent a resource from being blocked
+# Specify a more permissive Cross-Origin Resource Policy to stop a resource from being blocked
 
 Your site tries to access an external resource that only allows same-origin usage.
-This behavior prevents a document from loading any non-same-origin resources which don’t explicitly grant permission to be loaded.
+This behavior stops a document from loading any non-same-origin resources which don’t explicitly grant permission to be loaded.
 
 To solve this, add the following to the resource’s HTML response header:
 * `Cross-Origin-Resource-Policy: same-site` if the resource and your site are served from the same site.

package/front_end/models/issues_manager/descriptions/CoepCorpNotSameOriginAfterDefaultedToSameOriginByCoep.md

@@ -1,11 +1,11 @@
-# Specify a Cross-Origin Resource Policy to prevent a resource from being blocked
+# Specify a Cross-Origin Resource Policy to stop a resource from being blocked
 
 Because your site has the Cross-Origin Embedder Policy (COEP) enabled, each
 resource must specify a suitable Cross-Origin Resource Policy (CORP). This
-behavior prevents a document from loading cross-origin resources which don’t
+behavior stops a document from loading cross-origin resources which don’t
 explicitly grant permission to be loaded.
 
-To solve this, add the following to the resource’ response header:
+To solve this, add the following to the resource’s response header:
 * `Cross-Origin-Resource-Policy: same-site` if the resource and your site are
   served from the same site.
 * `Cross-Origin-Resource-Policy: cross-origin` if the resource is served from

package/front_end/models/issues_manager/descriptions/CoepCorpNotSameSite.md

@@ -1,7 +1,7 @@
-# Specify a more permissive Cross-Origin Resource Policy to prevent a resource from being blocked
+# Specify a more permissive Cross-Origin Resource Policy to stop a resource from being blocked
 
 Your site tries to access an external resource that only allows same-site usage.
-This behavior prevents a document from loading any non-same-site resources which don’t explicitly grant permission to be loaded.
+This behavior stops a document from loading any non-same-site resources which don’t explicitly grant permission to be loaded.
 
 To solve this, add the following to the resource’s HTML response header: `Cross-Origin-Resource-Policy: cross-origin`
 ⚠️If you set this header, any website can embed this resource.

package/front_end/models/issues_manager/descriptions/CoepFrameResourceNeedsCoepHeader.md

@@ -1,4 +1,4 @@
-# Specify a Cross-Origin Embedder Policy to prevent this frame from being blocked
+# Specify a Cross-Origin Embedder Policy to stop this frame from being blocked
 
 Because your site has the Cross-Origin Embedder Policy (COEP) enabled, each
 embedded iframe must also specify this policy. This behavior protects private

package/front_end/models/issues_manager/descriptions/CompatibilityModeQuirks.md

@@ -2,4 +2,4 @@
 
 One or more documents in this page is in Quirks Mode, which will render the affected document(s) with quirks incompatible with the current HTML and CSS specifications.
 
-Quirks Mode exists mostly due to historical reasons. If this is not intentional, you can [add or modify the DOCTYPE to be `<!DOCTYPE html>`](issueQuirksModeDoctype) to render the page in No Quirks Mode.
+Quirks Mode exists mostly due to historical reasons. If this isn’t intentional, you can [add or modify the DOCTYPE to be `<!DOCTYPE html>`](issueQuirksModeDoctype) to render the page in No Quirks Mode.

package/front_end/models/issues_manager/descriptions/CookieAttributeValueExceedsMaxSize.md

@@ -1,5 +1,5 @@
 # Ensure cookie attribute values don’t exceed 1024 characters
 
-Cookie attribute values exceeding 1024 characters in size will result in the attribute being ignored. This could lead to unexpected behavior since the cookie will be processed as if the offending attribute / attribute value pair were not present.
+Cookie attribute values exceeding 1024 characters in size will result in the attribute being ignored. This could lead to unexpected behavior since the cookie will be processed as if the offending attribute / attribute value pair weren’t present.
 
-Resolve this issue by ensuring that cookie attribute values don’t exceed 1024 characters.
+Resolve this issue by ensuring that cookie attribute values don’t exceed 1024 characters.

package/front_end/models/issues_manager/descriptions/LowTextContrast.md

@@ -2,4 +2,4 @@
 
 Low-contrast text is difficult or impossible for users to read. A [minimum contrast ratio (AA) of 4.5](issuesContrastWCAG21AA) is recommended for all text. Since font size and weight affect color perception, an exception is made for very large or bold text — in this case, a contrast ratio of 3.0 is allowed. The [enhanced conformance level (AAA)](issuesContrastWCAG21AAA) requires the contrast ratio to be above 7.0 for regular text and 4.5 for large text.
 
-Update colors or change the font size or weight to achieve sufficient contrast. You can use the [“Suggest color” feature](issuesContrastSuggestColor) in the DevTools color picker to automatically select a better text color.
+Update colors or change the font size or weight to achieve sufficient contrast. You can use the [“Suggest color” feature](issuesContrastSuggestColor) in the DevTools color picker to automatically select a better text color.

package/front_end/models/issues_manager/descriptions/SameSiteNoneInsecureErrorRead.md

@@ -5,4 +5,4 @@ This behavior protects user data from being sent over an insecure connection.
 
 Resolve this issue by updating the attributes of the cookie:
 * Specify `SameSite=None` and `Secure` if the cookie should be sent in cross-site requests. This enables third-party use.
-* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie should not be sent in cross-site requests.
+* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie shouldn’t be sent in cross-site requests.

package/front_end/models/issues_manager/descriptions/SameSiteNoneInsecureErrorSet.md

@@ -5,4 +5,4 @@ This behavior protects user data from being sent over an insecure connection.
 
 Resolve this issue by updating the attributes of the cookie:
 * Specify `SameSite=None` and `Secure` if the cookie is intended to be set in cross-site contexts. Note that only cookies sent over HTTPS may use the `Secure` attribute.
-* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie should not be set by cross-site requests.
+* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie shouldn’t be set by cross-site requests.

package/front_end/models/issues_manager/descriptions/SameSiteNoneInsecureWarnRead.md

@@ -5,4 +5,4 @@ This behavior protects user data from being sent over an insecure connection.
 
 Resolve this issue by updating the attributes of the cookie:
 * Specify `SameSite=None` and `Secure` if the cookie should be sent in cross-site requests. This enables third-party use.
-* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie should not be sent in cross-site requests.
+* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie shouldn’t be sent in cross-site requests.

package/front_end/models/issues_manager/descriptions/SameSiteNoneInsecureWarnSet.md

@@ -5,4 +5,4 @@ This behavior protects user data from being sent over an insecure connection.
 
 Resolve this issue by updating the attributes of the cookie:
 * Specify `SameSite=None` and `Secure` if the cookie is intended to be set in cross-site contexts. Note that only cookies sent over HTTPS may use the `Secure` attribute.
-* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie should not be set by cross-site requests.
+* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie shouldn’t be set by cross-site requests.

package/front_end/models/issues_manager/descriptions/SameSiteUnspecifiedLaxAllowUnsafeRead.md

@@ -1,9 +1,9 @@
 # Indicate whether to send a cookie in a cross-site request by specifying its SameSite attribute
 
-Because a cookie’s `SameSite` attribute was not set or is invalid, it defaults to `SameSite=Lax`,
-which will prevent the cookie from being sent in a cross-site request in a future version of the browser.
+Because a cookie’s `SameSite` attribute wasn’t set or is invalid, it defaults to `SameSite=Lax`,
+which will stop the cookie from being sent in a cross-site request in a future version of the browser.
 This behavior protects user data from accidentally leaking to third parties and cross-site request forgery.
 
 Resolve this issue by updating the attributes of the cookie:
 * Specify `SameSite=None` and `Secure` if the cookie should be sent in cross-site requests. This enables third-party use.
-* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie should not be sent in cross-site requests.
+* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie shouldn’t be sent in cross-site requests.

package/front_end/models/issues_manager/descriptions/SameSiteUnspecifiedLaxAllowUnsafeSet.md

@@ -1,9 +1,9 @@
 # Indicate whether a cookie is intended to be set in cross-site context by specifying its SameSite attribute
 
-Because a cookie’s `SameSite` attribute was not set or is invalid, it defaults to `SameSite=Lax`,
-which will prevents the cookie from being set in a cross-site context in a future version of the browser.
+Because a cookie’s `SameSite` attribute wasn’t set or is invalid, it defaults to `SameSite=Lax`,
+which will stops the cookie from being set in a cross-site context in a future version of the browser.
 This behavior protects user data from accidentally leaking to third parties and cross-site request forgery.
 
 Resolve this issue by updating the attributes of the cookie:
 * Specify `SameSite=None` and `Secure` if the cookie is intended to be set in cross-site contexts. Note that only cookies sent over HTTPS may use the `Secure` attribute.
-* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie should not be set by cross-site requests.
+* Specify `SameSite=Strict` or `SameSite=Lax` if the cookie shouldn’t be set by cross-site requests.

package/front_end/models/issues_manager/descriptions/bounceTrackingMitigations.md

@@ -1,3 +1,3 @@
 # Chrome may soon delete state for intermediate websites in a recent navigation chain
 
-In a recent navigation chain, one or more websites without prior user interaction were visited. If these websites don't get such an interaction soon, Chrome will delete their state.
+In a recent navigation chain, one or more websites without prior user interaction were visited. If these websites don’t get such an interaction soon, Chrome will delete their state.

package/front_end/models/issues_manager/descriptions/connectionAllowlistInvalidAllowlistItemType.md

@@ -1,6 +1,6 @@
-# An item in the `Connection-Allowlist` header is invalid.
+# An item in the `Connection-Allowlist` header is invalid
 
-Each item in the `Connection-Allowlist`'s header's [Inner List](sfInnerList)
+Each item in the `Connection-Allowlist`’s header’s [Inner List](sfInnerList)
 must be a [String](sfString) representing a [URL Pattern](urlPatternSpec), or
 the [Token](sfToken) `response-origin`.
 

package/front_end/models/issues_manager/descriptions/connectionAllowlistInvalidHeader.md

@@ -1,6 +1,6 @@
-# The `Connection-Allowlist` header is not formatted as a Structured Field List.
+# The `Connection-Allowlist` header isn’t formatted as a Structured Field List
 
-Responses' `Connection-Allowlist` header should be formatted as a [List](sfList)
+Responses’ `Connection-Allowlist` header should be formatted as a [List](sfList)
 containing a single [Inner List](sfInnerList) that declares the allowed set of
 [URL Patterns](urlPatternSpec) for a given context.
 

package/front_end/models/issues_manager/descriptions/connectionAllowlistInvalidUrlPattern.md

@@ -1,8 +1,8 @@
-# An item in the `Connection-Allowlist` header is not a valid URL pattern.
+# An item in the `Connection-Allowlist` header isn’t a valid URL pattern
 
 Each item in the `Connection-Allowlist` header must be a valid
-[URL Pattern](urlPatternSpec) that can be used to match against the request's
+[URL Pattern](urlPatternSpec) that can be used to match against the request’s
 origin.
 
-Note that our current implementation does not allow regular expressions to be
+Note that our current implementation doesn’t allow regular expressions to be
 used as part of the pattern.

package/front_end/models/issues_manager/descriptions/connectionAllowlistItemNotInnerList.md

@@ -1,6 +1,6 @@
-# An item in the `Connection-Allowlist` header is not an Inner List.
+# An item in the `Connection-Allowlist` header isn’t an Inner List
 
-Responses' `Connection-Allowlist` header should be formatted as a [List](sfList)
+Responses’ `Connection-Allowlist` header should be formatted as a [List](sfList)
 containing a single [Inner List](sfInnerList) that declares the allowed set of
 [URL Patterns](urlPatternSpec) for a given context.
 

package/front_end/models/issues_manager/descriptions/connectionAllowlistMoreThanOneList.md

@@ -1,6 +1,6 @@
-# `Connection-Allowlist` has multiple items.
+# `Connection-Allowlist` has multiple items
 
-Responses' `Connection-Allowlist` header should be formatted as a [List](sfList)
+Responses’ `Connection-Allowlist` header should be formatted as a [List](sfList)
 containing a single [Inner List](sfInnerList) that declares the allowed set of
 [URL Patterns](urlPatternSpec) for a given context. This response was a
 [List](sfList) containing more than one item: all but the first have been

package/front_end/models/issues_manager/descriptions/connectionAllowlistReportingEndpointNotToken.md

@@ -1,4 +1,4 @@
-# The `report-to` parameter in the `Connection-Allowlist` header is not a token.
+# The `report-to` parameter in the `Connection-Allowlist` header isn’t a token
 
 If provided, the `report-to` parameter must be a [Token](sfToken)
 naming a reporting endpoint.

package/front_end/models/issues_manager/descriptions/cookieCrossSiteRedirectDowngrade.md

@@ -1,6 +1,6 @@
 # Cookie is blocked due to a cross-site redirect chain
 
-The cookie was blocked because the URL redirect chain was not fully same-site,
+The cookie was blocked because the URL redirect chain wasn’t fully same-site,
 meaning the final request was treated as a cross-site request.
 Like other cross-site requests, this blocks cookies with `SameSite=Lax` or
 `SameSite=Strict`.
@@ -8,5 +8,5 @@ Like other cross-site requests, this blocks cookies with `SameSite=Lax` or
 For example: If site A redirects to site B which then redirects back to site A,
 the final request to site A will be a cross-site request.
 
-If this behavior is causing breakage, please file a bug report with the link
-below.
+If this behavior is causing breakage, file a bug report with the link
+below.