chrome-devtools-frontend 1.0.1696961 → 1.0.1697998

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/.geminiignore +0 -1
  2. package/.stylelintignore +2 -0
  3. package/front_end/core/common/Color.ts +5 -2
  4. package/front_end/core/common/VersionController.ts +5 -1
  5. package/front_end/core/host/InspectorFrontendHostAPI.ts +16 -3
  6. package/front_end/core/host/InspectorFrontendHostStub.ts +3 -2
  7. package/front_end/core/host/ResourceLoader.ts +1 -2
  8. package/front_end/core/platform/api/HostRuntime.ts +1 -0
  9. package/front_end/core/platform/browser/HostRuntime.ts +4 -0
  10. package/front_end/core/platform/node/HostRuntime.ts +5 -0
  11. package/front_end/core/root/Runtime.ts +5 -0
  12. package/front_end/core/sdk/AnimationModel.ts +9 -1
  13. package/front_end/core/sdk/DOMModel.ts +13 -0
  14. package/front_end/core/sdk/SourceMapScopeChainEntry.ts +9 -6
  15. package/front_end/core/sdk/SourceMapScopesInfo.ts +3 -1
  16. package/front_end/foundation/Universe.ts +8 -0
  17. package/front_end/generated/InspectorBackendCommands.ts +4 -1
  18. package/front_end/generated/protocol-mapping.d.ts +19 -0
  19. package/front_end/generated/protocol-proxy-api.d.ts +15 -0
  20. package/front_end/generated/protocol.ts +43 -2
  21. package/front_end/models/ai_assistance/AiAgent2.ts +20 -18
  22. package/front_end/models/ai_assistance/AiConversation.ts +38 -12
  23. package/front_end/models/ai_assistance/agents/AccessibilityAgent.ts +9 -2
  24. package/front_end/models/ai_assistance/agents/ContextSelectionAgent.ts +26 -0
  25. package/front_end/models/ai_assistance/agents/StylingAgent.ts +13 -4
  26. package/front_end/models/ai_assistance/ai_assistance.ts +4 -4
  27. package/front_end/models/ai_assistance/skills/performance.md +4 -3
  28. package/front_end/models/ai_assistance/tools/CookieUtils.ts +10 -8
  29. package/front_end/models/ai_assistance/tools/ExecuteJavaScript.ts +1 -1
  30. package/front_end/models/ai_assistance/tools/GetElementAccessibilityDetails.ts +1 -3
  31. package/front_end/models/ai_assistance/tools/GetNetworkRequestDetails.ts +9 -8
  32. package/front_end/models/ai_assistance/tools/GetSourceContent.ts +5 -6
  33. package/front_end/models/ai_assistance/tools/GetStorageValues.ts +6 -25
  34. package/front_end/models/ai_assistance/tools/GetStyles.ts +1 -3
  35. package/front_end/models/ai_assistance/tools/{GetFunctionCode.ts → GetTraceFunctionCode.ts} +26 -13
  36. package/front_end/models/ai_assistance/tools/{GetResourceContent.ts → GetTraceResourceContent.ts} +31 -11
  37. package/front_end/models/ai_assistance/tools/ListNetworkRequests.ts +7 -6
  38. package/front_end/models/ai_assistance/tools/ListPageOrigins.ts +8 -5
  39. package/front_end/models/ai_assistance/tools/ListSources.ts +8 -10
  40. package/front_end/models/ai_assistance/tools/ListStorageKeys.ts +6 -25
  41. package/front_end/models/ai_assistance/tools/README.md +5 -3
  42. package/front_end/models/ai_assistance/tools/ResolveDevtoolsNodePath.ts +1 -2
  43. package/front_end/models/ai_assistance/tools/Tool.ts +54 -16
  44. package/front_end/models/ai_assistance/tools/ToolRegistry.ts +6 -6
  45. package/front_end/models/change_tracker/ChangeTracker.ts +89 -0
  46. package/front_end/models/change_tracker/change_tracker.ts +9 -0
  47. package/front_end/models/elements/DOMChanges.ts +238 -0
  48. package/front_end/models/elements/elements.ts +2 -0
  49. package/front_end/models/issues_manager/MarkdownIssueDescription.ts +2 -2
  50. package/front_end/models/live-metrics/LiveMetrics.ts +1 -2
  51. package/front_end/models/trace/ModelImpl.ts +0 -6
  52. package/front_end/models/trace/Processor.ts +4 -7
  53. package/front_end/models/trace/helpers/Timing.ts +2 -1
  54. package/front_end/models/trace/types/Overlays.ts +12 -1
  55. package/front_end/panels/accessibility/AccessibilityAnnouncementRecordingView.ts +67 -19
  56. package/front_end/panels/ai_assistance/AiAssistancePanel.ts +3 -1
  57. package/front_end/panels/ai_assistance/components/MarkdownRendererWithCodeBlock.ts +25 -5
  58. package/front_end/panels/application/IndexedDBViews.ts +1 -1
  59. package/front_end/panels/browser_debugger/ObjectEventListenersSidebarPane.ts +2 -3
  60. package/front_end/panels/elements/DOMTreeContextMenu.ts +16 -23
  61. package/front_end/panels/elements/ElementsTreeElement.ts +384 -79
  62. package/front_end/panels/elements/ElementsTreeOutline.ts +541 -82
  63. package/front_end/panels/elements/EventListenersWidget.ts +0 -1
  64. package/front_end/panels/event_listeners/EventListenersView.ts +241 -297
  65. package/front_end/panels/linear_memory_inspector/LinearMemoryInspectorController.ts +1 -1
  66. package/front_end/panels/mobile_throttling/ThrottlingSettingsTab.ts +10 -2
  67. package/front_end/panels/network/NetworkConfigView.ts +141 -116
  68. package/front_end/panels/network/NetworkPanel.ts +140 -52
  69. package/front_end/panels/network/RequestHeadersView.ts +65 -32
  70. package/front_end/panels/network/components/RequestHeadersView.css +7 -1
  71. package/front_end/panels/network/forward/BackendLinking.ts +52 -0
  72. package/front_end/panels/network/forward/forward.ts +2 -0
  73. package/front_end/panels/settings/BackendLinkingSettingsTab.ts +308 -0
  74. package/front_end/panels/settings/backendLinkingSettingsTab.css +78 -0
  75. package/front_end/panels/settings/settings-meta.ts +25 -0
  76. package/front_end/panels/settings/settings.ts +2 -0
  77. package/front_end/panels/timeline/README.md +3 -2
  78. package/front_end/panels/timeline/TimelineFlameChartView.ts +23 -2
  79. package/front_end/panels/timeline/TimelineTreeView.ts +11 -1
  80. package/front_end/panels/timeline/overlays/OverlaysImpl.ts +64 -4
  81. package/front_end/panels/timeline/timelineFlameChartView.css +47 -0
  82. package/front_end/panels/whats_new/ReleaseNoteText.ts +8 -8
  83. package/front_end/panels/whats_new/resources/WNDT.md +6 -6
  84. package/front_end/third_party/chromium/README.chromium +1 -1
  85. package/front_end/third_party/puppeteer/README.chromium +2 -2
  86. package/front_end/third_party/puppeteer/package/lib/es5-iife/puppeteer-core-browser.d.ts +6 -0
  87. package/front_end/third_party/puppeteer/package/lib/es5-iife/puppeteer-core-browser.js +5 -8
  88. package/front_end/third_party/puppeteer/package/lib/puppeteer/cdp/Coverage.d.ts +6 -0
  89. package/front_end/third_party/puppeteer/package/lib/puppeteer/cdp/Coverage.d.ts.map +1 -1
  90. package/front_end/third_party/puppeteer/package/lib/puppeteer/cdp/Coverage.js.map +1 -1
  91. package/front_end/third_party/puppeteer/package/lib/puppeteer/cdp/ScreenRecording.d.ts.map +1 -1
  92. package/front_end/third_party/puppeteer/package/lib/puppeteer/cdp/ScreenRecording.js +1 -5
  93. package/front_end/third_party/puppeteer/package/lib/puppeteer/cdp/ScreenRecording.js.map +1 -1
  94. package/front_end/third_party/puppeteer/package/lib/puppeteer/revisions.d.ts +3 -3
  95. package/front_end/third_party/puppeteer/package/lib/puppeteer/revisions.js +3 -3
  96. package/front_end/third_party/puppeteer/package/lib/puppeteer/revisions.js.map +1 -1
  97. package/front_end/third_party/puppeteer/package/lib/puppeteer/util/version.d.ts +1 -1
  98. package/front_end/third_party/puppeteer/package/lib/puppeteer/util/version.js +1 -1
  99. package/front_end/third_party/puppeteer/package/lib/types.d.ts +6 -0
  100. package/front_end/third_party/puppeteer/package/package.json +2 -2
  101. package/front_end/third_party/puppeteer/package/src/cdp/Coverage.ts +6 -0
  102. package/front_end/third_party/puppeteer/package/src/cdp/ScreenRecording.ts +3 -7
  103. package/front_end/third_party/puppeteer/package/src/revisions.ts +3 -3
  104. package/front_end/third_party/puppeteer/package/src/util/version.ts +1 -1
  105. package/front_end/third_party/web-vitals/README.chromium +2 -2
  106. package/front_end/third_party/web-vitals/package/dist/modules/attribution/onINP.js +8 -5
  107. package/front_end/third_party/web-vitals/package/package.json +1 -1
  108. package/front_end/third_party/web-vitals/package/src/attribution/onINP.ts +8 -4
  109. package/front_end/third_party/web-vitals/rebuild.sh +2 -2
  110. package/front_end/ui/comments/CommentOverlayManager.ts +169 -40
  111. package/front_end/ui/comments/CommentThreadWidget.ts +221 -0
  112. package/front_end/ui/comments/CommentsOverlayWidget.ts +124 -12
  113. package/front_end/ui/comments/commentThreadWidget.css +173 -0
  114. package/front_end/ui/comments/comments.ts +2 -0
  115. package/front_end/ui/comments/commentsOverlay.css +6 -0
  116. package/front_end/ui/legacy/ContextMenu.ts +19 -0
  117. package/front_end/ui/legacy/SoftContextMenu.ts +6 -0
  118. package/front_end/ui/legacy/components/object_ui/ObjectPropertiesSection.ts +1 -1
  119. package/front_end/ui/legacy/components/perf_ui/FlameChart.ts +66 -22
  120. package/front_end/ui/visual_logging/KnownContextValues.ts +4 -0
  121. package/package.json +9 -8
@@ -7,10 +7,12 @@ import * as Common from '../../core/common/common.js';
7
7
  import * as Host from '../../core/host/host.js';
8
8
  import * as i18n from '../../core/i18n/i18n.js';
9
9
  import * as Platform from '../../core/platform/platform.js';
10
+ import * as Root from '../../core/root/root.js';
10
11
  import * as SDK from '../../core/sdk/sdk.js';
11
12
  import * as Persistence from '../../models/persistence/persistence.js';
12
13
  import * as Workspace from '../../models/workspace/workspace.js';
13
14
  import * as NetworkForward from '../../panels/network/forward/forward.js';
15
+ import * as Buttons from '../../ui/components/buttons/buttons.js';
14
16
  import * as Input from '../../ui/components/input/input.js';
15
17
  import * as UI from '../../ui/legacy/legacy.js';
16
18
  import * as Lit from '../../ui/lit/lit.js';
@@ -18,6 +20,7 @@ import * as VisualLogging from '../../ui/visual_logging/visual_logging.js';
18
20
  import * as Sources from '../sources/sources.js';
19
21
 
20
22
  import * as NetworkComponents from './components/components.js';
23
+ import {NetworkPanel} from './NetworkPanel.js';
21
24
  import {ShowMoreDetailsWidget} from './ShowMoreDetailsWidget.js';
22
25
 
23
26
  const {render, html} = Lit;
@@ -97,6 +100,11 @@ const UIStrings = {
97
100
  * @description HTTP response code
98
101
  */
99
102
  statusCode: 'Status code',
103
+ /**
104
+ * @description Text in Request Headers View of the Network panel for opening a backend link with a named service
105
+ * @example {Dashboard} PH1
106
+ */
107
+ openWith: 'Open with {PH1}',
100
108
  } as const;
101
109
  const str_ = i18n.i18n.registerUIStrings('panels/network/RequestHeadersView.ts', UIStrings);
102
110
  const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
@@ -110,6 +118,7 @@ interface ViewInput {
110
118
  toggleShowRawRequestHeaders: () => void;
111
119
  revealHeadersFile?: () => void;
112
120
  toReveal?: {section: NetworkForward.UIRequestLocation.UIHeaderSection, header?: string};
121
+ backendLink: {label: string, url: URL}|null;
113
122
  }
114
123
  type View = (input: ViewInput, output: object, target: HTMLElement) => void;
115
124
 
@@ -194,16 +203,16 @@ export const DEFAULT_VIEW: View = (input, _output, target) => {
194
203
  ${input.cacheDisabled && hasEarlyHintsPreload(input.request.earlyHintsHeaders) ?
195
204
  renderEarlyHintsWarning() : Lit.nothing}
196
205
  ${input.showResponseHeadersText ?
197
- renderRawHeaders(input.request.responseHeadersText) :
198
- html`
199
- <devtools-early-hints-header-section .data=${
200
- {
201
- request: input.request,
202
- toReveal: input.toReveal,
203
- } as NetworkComponents.ResponseHeaderSection
204
- .ResponseHeaderSectionData}></devtools-early-hints-header-section>
206
+ renderRawHeaders(input.request.responseHeadersText) :
207
+ html`
208
+ <devtools-early-hints-header-section .data=${
209
+ {
210
+ request: input.request,
211
+ toReveal: input.toReveal,
212
+ } as NetworkComponents.ResponseHeaderSection
213
+ .ResponseHeaderSectionData}></devtools-early-hints-header-section>
205
214
  `}
206
- `,
215
+ `,
207
216
  })}
208
217
  ${renderCategory({
209
218
  name: 'response-headers',
@@ -211,7 +220,7 @@ export const DEFAULT_VIEW: View = (input, _output, target) => {
211
220
  title: i18nString(UIStrings.responseHeaders),
212
221
  headerCount: input.request.sortedResponseHeaders.length,
213
222
  checked: input.request.responseHeadersText ? input.showResponseHeadersText : undefined,
214
- additionalContent: renderHeaderOverridesLink(input),
223
+ additionalContent: html`<div>${renderHeaderOverridesLink(input)}${renderBackendLinkButton(input)}</div>`,
215
224
  forceOpen: input.toReveal?.section === NetworkForward.UIRequestLocation.UIHeaderSection.RESPONSE,
216
225
  loggingContext: 'response-headers',
217
226
  contents: input.showResponseHeadersText ?
@@ -293,12 +302,12 @@ export class RequestHeadersView extends UI.Widget.Widget {
293
302
  this.#request?.addEventListener(SDK.NetworkRequest.Events.REMOTE_ADDRESS_CHANGED, this.#refreshHeadersView, this);
294
303
  this.#request?.addEventListener(SDK.NetworkRequest.Events.FINISHED_LOADING, this.#refreshHeadersView, this);
295
304
  this.#request?.addEventListener(SDK.NetworkRequest.Events.REQUEST_HEADERS_CHANGED, this.#refreshHeadersView, this);
296
- this.#request?.addEventListener(
297
- SDK.NetworkRequest.Events.RESPONSE_HEADERS_CHANGED, this.#resetAndRefreshHeadersView, this);
298
- this.#workspace.addEventListener(
299
- Workspace.Workspace.Events.UISourceCodeAdded, this.#uiSourceCodeAddedOrRemoved, this);
300
- this.#workspace.addEventListener(
301
- Workspace.Workspace.Events.UISourceCodeRemoved, this.#uiSourceCodeAddedOrRemoved, this);
305
+ this.#request?.addEventListener(SDK.NetworkRequest.Events.RESPONSE_HEADERS_CHANGED,
306
+ this.#resetAndRefreshHeadersView, this);
307
+ this.#workspace.addEventListener(Workspace.Workspace.Events.UISourceCodeAdded, this.#uiSourceCodeAddedOrRemoved,
308
+ this);
309
+ this.#workspace.addEventListener(Workspace.Workspace.Events.UISourceCodeRemoved, this.#uiSourceCodeAddedOrRemoved,
310
+ this);
302
311
  Common.Settings.Settings.instance()
303
312
  .resolve(Persistence.NetworkPersistenceManager.persistenceNetworkOverridesEnabledSettingDescriptor)
304
313
  .addChangeListener(this.requestUpdate, this);
@@ -317,17 +326,17 @@ export class RequestHeadersView extends UI.Widget.Widget {
317
326
  }
318
327
 
319
328
  #removeEventListeners(): void {
320
- this.#request?.removeEventListener(
321
- SDK.NetworkRequest.Events.REMOTE_ADDRESS_CHANGED, this.#refreshHeadersView, this);
329
+ this.#request?.removeEventListener(SDK.NetworkRequest.Events.REMOTE_ADDRESS_CHANGED, this.#refreshHeadersView,
330
+ this);
322
331
  this.#request?.removeEventListener(SDK.NetworkRequest.Events.FINISHED_LOADING, this.#refreshHeadersView, this);
323
- this.#request?.removeEventListener(
324
- SDK.NetworkRequest.Events.REQUEST_HEADERS_CHANGED, this.#refreshHeadersView, this);
325
- this.#request?.removeEventListener(
326
- SDK.NetworkRequest.Events.RESPONSE_HEADERS_CHANGED, this.#resetAndRefreshHeadersView, this);
327
- this.#workspace.removeEventListener(
328
- Workspace.Workspace.Events.UISourceCodeAdded, this.#uiSourceCodeAddedOrRemoved, this);
329
- this.#workspace.removeEventListener(
330
- Workspace.Workspace.Events.UISourceCodeRemoved, this.#uiSourceCodeAddedOrRemoved, this);
332
+ this.#request?.removeEventListener(SDK.NetworkRequest.Events.REQUEST_HEADERS_CHANGED, this.#refreshHeadersView,
333
+ this);
334
+ this.#request?.removeEventListener(SDK.NetworkRequest.Events.RESPONSE_HEADERS_CHANGED,
335
+ this.#resetAndRefreshHeadersView, this);
336
+ this.#workspace.removeEventListener(Workspace.Workspace.Events.UISourceCodeAdded, this.#uiSourceCodeAddedOrRemoved,
337
+ this);
338
+ this.#workspace.removeEventListener(Workspace.Workspace.Events.UISourceCodeRemoved,
339
+ this.#uiSourceCodeAddedOrRemoved, this);
331
340
  Common.Settings.Settings.instance()
332
341
  .resolve(Persistence.NetworkPersistenceManager.persistenceNetworkOverridesEnabledSettingDescriptor)
333
342
  .removeChangeListener(this.requestUpdate, this);
@@ -381,6 +390,9 @@ export class RequestHeadersView extends UI.Widget.Widget {
381
390
  cacheDisabled: this.#request.cacheDisabled(),
382
391
  showResponseHeadersText: this.#showResponseHeadersText,
383
392
  showRequestHeadersText: this.#showRequestHeadersText,
393
+ backendLink: Root.Runtime.hostConfig.devToolsNetworkBackendLinking?.enabled ?
394
+ NetworkPanel.instance().backendLinking?.getLink(this.#request) ?? null :
395
+ null,
384
396
  };
385
397
 
386
398
  this.#view(input, {}, this.contentElement);
@@ -422,6 +434,28 @@ function renderEarlyHintsWarning(): Lit.LitTemplate {
422
434
  `;
423
435
  }
424
436
 
437
+ function renderBackendLinkButton({backendLink}: ViewInput): Lit.LitTemplate {
438
+ if (!backendLink) {
439
+ return Lit.nothing;
440
+ }
441
+ // clang-format off
442
+ return html`
443
+ <devtools-button
444
+ class="backend-link-button"
445
+ .variant=${Buttons.Button.Variant.PRIMARY}
446
+ .size=${Buttons.Button.Size.SMALL}
447
+ jslog=${VisualLogging.action('open-backend-link').track({click: true})}
448
+ title=${backendLink.url}
449
+ @click=${(event: Event) => {
450
+ event.consume(true);
451
+ Host.InspectorFrontendHost.InspectorFrontendHostInstance.openInNewTab(
452
+ Platform.DevToolsPath.urlString`${backendLink.url}`);
453
+ }}>
454
+ ${i18nString(UIStrings.openWith, {PH1: backendLink.label})}
455
+ </devtools-button>
456
+ `;
457
+ // clang-format on
458
+ }
425
459
  function renderHeaderOverridesLink(input: ViewInput): Lit.LitTemplate {
426
460
  if (!input.revealHeadersFile) {
427
461
  return Lit.nothing;
@@ -445,7 +479,7 @@ function renderHeaderOverridesLink(input: ViewInput): Lit.LitTemplate {
445
479
  return html`
446
480
  <devtools-link
447
481
  href="https://goo.gle/devtools-override"
448
- class="link devtools-link"
482
+ class="link devtools-link hide-when-closed"
449
483
  jslogcontext="devtools-override"
450
484
  >
451
485
  <devtools-icon name="help" class="inline-icon">
@@ -453,7 +487,7 @@ function renderHeaderOverridesLink(input: ViewInput): Lit.LitTemplate {
453
487
  </devtools-link>
454
488
  <devtools-link
455
489
  @click=${revealHeadersFile}
456
- class="link devtools-link"
490
+ class="link devtools-link hide-when-closed"
457
491
  title=${UIStrings.revealHeaderOverrides}
458
492
  jslogcontext="reveal-header-overrides"
459
493
  >
@@ -468,9 +502,8 @@ function renderRawHeaders(text: string): Lit.TemplateResult {
468
502
  ${widget(ShowMoreDetailsWidget, {text})}></devtools-widget></div>`;
469
503
  }
470
504
 
471
- function renderGeneralRow(
472
- input: ViewInput, name: Common.UIString.LocalizedString, value: string, id: string,
473
- classNames?: string[]): Lit.LitTemplate {
505
+ function renderGeneralRow(input: ViewInput, name: Common.UIString.LocalizedString, value: string, id: string,
506
+ classNames?: string[]): Lit.LitTemplate {
474
507
  const isHighlighted = input.toReveal?.section === NetworkForward.UIRequestLocation.UIHeaderSection.GENERAL &&
475
508
  name.toLowerCase() === input.toReveal?.header?.toLowerCase();
476
509
  return html`
@@ -523,7 +556,7 @@ export function renderCategory(data: {
523
556
  ${i18nString(UIStrings.raw)}
524
557
  </devtools-checkbox>` : Lit.nothing}
525
558
  </div>
526
- <div class="hide-when-closed">${data.additionalContent}</div>
559
+ ${data.additionalContent}
527
560
  </div>
528
561
  </summary>
529
562
  ${data.contents}
@@ -35,7 +35,7 @@ details .hide-when-closed {
35
35
  }
36
36
 
37
37
  details[open] .hide-when-closed {
38
- display: block;
38
+ display: revert;
39
39
  }
40
40
 
41
41
  details summary input {
@@ -158,6 +158,7 @@ div.raw-headers-row {
158
158
 
159
159
  .header-grid-container div:last-child {
160
160
  text-align: right;
161
+ white-space: nowrap;
161
162
  }
162
163
 
163
164
  .header .devtools-link {
@@ -196,3 +197,8 @@ summary label {
196
197
  summary devtools-checkbox {
197
198
  margin-top: var(--sys-size-1);
198
199
  }
200
+
201
+ .backend-link-button {
202
+ margin-left: var(--sys-size-4);
203
+ vertical-align: middle;
204
+ }
@@ -0,0 +1,52 @@
1
+ // Copyright 2026 The Chromium Authors
2
+ // Use of this source code is governed by a BSD-style license that can be
3
+ // found in the LICENSE file.
4
+
5
+ import * as Common from '../../../core/common/common.js';
6
+
7
+ /**
8
+ * Configuration rule for backend network request debugging links.
9
+ * Matches network requests against a URL pattern and constructs a destination URL
10
+ * from `targetUrlTemplate` using extracted correlation IDs.
11
+ *
12
+ * Supported placeholders in `targetUrlTemplate`:
13
+ * - `${devtoolsDebugId}`: Extracted from `Server-Timing: devtools-debug-id;desc="<id>"`
14
+ * - `${requestId}`: Extracted from `X-Request-ID` response header
15
+ * - `${correlationId}`: Extracted from `X-Correlation-ID` or `Correlation-ID` response header
16
+ * - `${traceId}`: Extracted from `trace-id` response header or 16-byte hex trace ID in `Server-Timing: traceparent`
17
+ * - `${spanId}`: Extracted from 8-byte hex parent span ID in `Server-Timing: traceparent`
18
+ *
19
+ * Example rule:
20
+ * ```json
21
+ * {
22
+ * "urlPattern": "https://example.com/api/*",
23
+ * "targetUrlTemplate": "https://apm.example.com/traces/${traceId}?span=${spanId}",
24
+ * "label": "Open in APM"
25
+ * }
26
+ * ```
27
+ */
28
+ export interface BackendLinkingRule {
29
+ urlPattern: string;
30
+ targetUrlTemplate: string;
31
+ label: string;
32
+ }
33
+
34
+ export const BACKEND_LINKING_PLACEHOLDERS = [
35
+ '${devtoolsDebugId}',
36
+ '${requestId}',
37
+ '${correlationId}',
38
+ '${traceId}',
39
+ '${spanId}',
40
+ ] as const;
41
+
42
+ export type BackendLinkingPlaceholder = typeof BACKEND_LINKING_PLACEHOLDERS[number];
43
+
44
+ export const backendLinkingRulesSettingDescriptor:
45
+ Common.Settings.ConditionalSettingDescriptor<BackendLinkingRule[], void> = {
46
+ name: 'network.backend-linking-rules',
47
+ type: Common.Settings.SettingType.ARRAY,
48
+ defaultValue: [],
49
+ isAvailable: config => config.devToolsNetworkBackendLinking?.enabled ?
50
+ {status: Common.Settings.SettingAvailability.AVAILABLE} :
51
+ {status: Common.Settings.SettingAvailability.UNAVAILABLE, reason: undefined},
52
+ };
@@ -2,11 +2,13 @@
2
2
  // Use of this source code is governed by a BSD-style license that can be
3
3
  // found in the LICENSE file.
4
4
 
5
+ import * as BackendLinking from './BackendLinking.js';
5
6
  import * as NetworkRequestId from './NetworkRequestId.js';
6
7
  import * as UIFilter from './UIFilter.js';
7
8
  import * as UIRequestLocation from './UIRequestLocation.js';
8
9
 
9
10
  export {
11
+ BackendLinking,
10
12
  NetworkRequestId,
11
13
  UIFilter,
12
14
  UIRequestLocation,
@@ -0,0 +1,308 @@
1
+ // Copyright 2026 The Chromium Authors
2
+ // Use of this source code is governed by a BSD-style license that can be
3
+ // found in the LICENSE file.
4
+
5
+ import '../../ui/legacy/components/data_grid/data_grid.js';
6
+
7
+ import * as Common from '../../core/common/common.js';
8
+ import * as i18n from '../../core/i18n/i18n.js';
9
+ import * as UI from '../../ui/legacy/legacy.js';
10
+ import {Directives, html, nothing, render} from '../../ui/lit/lit.js';
11
+ import * as VisualLogging from '../../ui/visual_logging/visual_logging.js';
12
+ import * as NetworkForward from '../network/forward/forward.js';
13
+
14
+ import backendLinkingSettingsTabStyles from './backendLinkingSettingsTab.css.js';
15
+
16
+ const {ifDefined} = Directives;
17
+
18
+ const UIStrings = {
19
+ /**
20
+ * @description Title for the backend linking settings tab card in DevTools Settings.
21
+ */
22
+ rulesSectionHeading: 'Backend linking rules',
23
+ /**
24
+ * @description Title for the backend linking settings tab card in DevTools Settings.
25
+ */
26
+ placeholderDocHeading: 'Available placeholders',
27
+ /**
28
+ * @description Description explaining what backend linking rules do.
29
+ */
30
+ description:
31
+ 'Configure links to external backend debugging, APM, or tracing tools for matching network requests. Use placeholders to insert correlation IDs extracted from request and response headers.',
32
+ /**
33
+ * @description Header column title in the backend linking rules table for the URL pattern.
34
+ */
35
+ urlPatternColumn: 'URL pattern',
36
+ /**
37
+ * @description Header column title in the backend linking rules table for the target URL template.
38
+ */
39
+ targetUrlTemplateColumn: 'Target URL template',
40
+ /**
41
+ * @description Header column title in the backend linking rules table for the label.
42
+ */
43
+ labelColumn: 'Label',
44
+ /**
45
+ * @description Header column title in the placeholder reference table.
46
+ */
47
+ placeholderColumn: 'Placeholder',
48
+ /**
49
+ * @description Header source column title in the placeholder reference table.
50
+ */
51
+ headerColumn: 'Referenced header / property',
52
+ /**
53
+ * @description Description of the devtoolsDebugId placeholder. The placeholder values will always be `desc`, `devtools-debug-id`, and `Server-Timing`.
54
+ */
55
+ devtoolsDebugIdDescription: 'Value of the `desc` parameter in the `devtools-debug-id` `Server-Timing` entry',
56
+ /**
57
+ * @description Description of the requestId placeholder. The placeholder value will always be `X-Request-ID`.
58
+ */
59
+ requestIdDescription: 'Value of the `X-Request-ID` response header',
60
+ /**
61
+ * @description Description of the correlationId placeholder. The placeholder values will always be `X-Correlation-ID` and `Correlation-ID`.
62
+ */
63
+ correlationIdDescription: 'Value of the `X-Correlation-ID` or `Correlation-ID` response header',
64
+ /**
65
+ * @description Description of the traceId placeholder. The placeholder values will always be `trace-id`, `Server-Timing`, and `traceparent`.
66
+ */
67
+ traceIdDescription: '16-byte hex trace ID from the `trace-id` response header or `Server-Timing` `traceparent` entry',
68
+ /**
69
+ * @description Description of the spanId placeholder. The placeholder values will always be `Server-Timing` and `traceparent`.
70
+ */
71
+ spanIdDescription: '8-byte hex parent span ID from the `Server-Timing` `traceparent` entry',
72
+ /**
73
+ * @description Error message in the backend linking settings tab when the URL pattern is empty.
74
+ */
75
+ urlPatternCannotBeEmpty: 'URL pattern can’t be empty',
76
+ /**
77
+ * @description Error message in the backend linking settings tab when the URL pattern is invalid.
78
+ */
79
+ invalidUrlPattern: 'URL pattern must be a valid URL pattern',
80
+ /**
81
+ * @description Error message in the backend linking settings tab when the target URL template is empty.
82
+ */
83
+ targetUrlTemplateCannotBeEmpty: 'Target URL template can’t be empty',
84
+ /**
85
+ * @description Error message in the backend linking settings tab when the target URL template does not contain a
86
+ * placeholder.
87
+ */
88
+ templateRequiresPlaceholder: 'Target URL template must contain at least one placeholder',
89
+ /**
90
+ * @description Error message in the backend linking settings tab when the label is empty.
91
+ */
92
+ labelCannotBeEmpty: 'Label can’t be empty',
93
+ /**
94
+ * @description Warning message displayed below the backend linking rules table when one or more rules are invalid.
95
+ */
96
+ invalidRulesWarning: 'Invalid rules will not be applied or saved.',
97
+ } as const;
98
+
99
+ const str_ = i18n.i18n.registerUIStrings('panels/settings/BackendLinkingSettingsTab.ts', UIStrings);
100
+ const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
101
+
102
+ function validPattern(urlPattern: string): boolean {
103
+ try {
104
+ new URLPattern(urlPattern);
105
+ return true;
106
+ } catch {
107
+ return false;
108
+ }
109
+ }
110
+
111
+ function hasPlaceholder(targetUrlTemplate: string): boolean {
112
+ return NetworkForward.BackendLinking.BACKEND_LINKING_PLACEHOLDERS.some(placeholder =>
113
+ targetUrlTemplate.includes(placeholder));
114
+ }
115
+
116
+ function isRuleValid(rule: NetworkForward.BackendLinking.BackendLinkingRule): boolean {
117
+ return Boolean(rule.urlPattern) && validPattern(rule.urlPattern) && Boolean(rule.targetUrlTemplate) &&
118
+ hasPlaceholder(rule.targetUrlTemplate) && Boolean(rule.label);
119
+ }
120
+
121
+ export interface ViewInput {
122
+ rules: NetworkForward.BackendLinking.BackendLinkingRule[];
123
+ onAddRule: (rule: NetworkForward.BackendLinking.BackendLinkingRule) => void;
124
+ onUpdateRule: (oldRule: NetworkForward.BackendLinking.BackendLinkingRule,
125
+ newRule: NetworkForward.BackendLinking.BackendLinkingRule) => void;
126
+ onDeleteRule: (rule: NetworkForward.BackendLinking.BackendLinkingRule) => void;
127
+ }
128
+ export type View = (input: ViewInput, output: object, target: HTMLElement) => void;
129
+ export const DEFAULT_VIEW: View = (input, output, target) => {
130
+ const onCreate = (event: CustomEvent<{urlPattern?: string, targetUrlTemplate?: string, label?: string}>): void => {
131
+ const data = event.detail;
132
+ const urlPattern = data.urlPattern?.trim();
133
+ const targetUrlTemplate = data.targetUrlTemplate?.trim();
134
+ const label = data.label?.trim();
135
+ if (!urlPattern && !targetUrlTemplate && !label) {
136
+ return;
137
+ }
138
+ input.onAddRule({
139
+ urlPattern: urlPattern ?? '',
140
+ targetUrlTemplate: targetUrlTemplate ?? '',
141
+ label: label ?? '',
142
+ });
143
+ };
144
+
145
+ const onEdit = (rule: NetworkForward.BackendLinking.BackendLinkingRule,
146
+ event: CustomEvent<{columnId: string, valueBeforeEditing: string, newText: string}>): void => {
147
+ const {columnId, newText} = event.detail;
148
+ const newRule = {...rule};
149
+ if (columnId === 'urlPattern') {
150
+ newRule.urlPattern = newText.trim();
151
+ } else if (columnId === 'targetUrlTemplate') {
152
+ newRule.targetUrlTemplate = newText.trim();
153
+ } else if (columnId === 'label') {
154
+ newRule.label = newText.trim();
155
+ }
156
+ input.onUpdateRule(rule, newRule);
157
+ };
158
+
159
+ // clang-format off
160
+ render(html`
161
+ <style>${backendLinkingSettingsTabStyles}</style>
162
+ <style>${UI.inspectorCommonStyles}</style>
163
+ <div class="settings-card-container-wrapper" jslog=${VisualLogging.pane('backend-linking')}>
164
+ <div class="settings-card-container">
165
+ <devtools-card heading=${i18nString(UIStrings.rulesSectionHeading)}>
166
+ <p class="description-text">${i18nString(UIStrings.description)}</p>
167
+ <devtools-data-grid
168
+ name=${i18nString(UIStrings.rulesSectionHeading)}
169
+ striped
170
+ inline
171
+ @delete=${() => {}}
172
+ @create=${onCreate}>
173
+ <table>
174
+ <style>${backendLinkingSettingsTabStyles}</style>
175
+ <thead>
176
+ <tr>
177
+ <th id="urlPattern" editable>${i18nString(UIStrings.urlPatternColumn)}</th>
178
+ <th id="targetUrlTemplate" editable>${i18nString(UIStrings.targetUrlTemplateColumn)}</th>
179
+ <th id="label" editable>${i18nString(UIStrings.labelColumn)}</th>
180
+ </tr>
181
+ </thead>
182
+ <tbody>
183
+ ${input.rules.map(rule => {
184
+ return html`
185
+ <tr @edit=${
186
+ (event: CustomEvent<{columnId: string, valueBeforeEditing: string, newText: string}>) =>
187
+ onEdit(rule, event)}
188
+ @delete=${() => input.onDeleteRule(rule)}>
189
+ <td title=${ifDefined(
190
+ !rule.urlPattern ? i18nString(UIStrings.urlPatternCannotBeEmpty) :
191
+ !validPattern(rule.urlPattern) ? i18nString(UIStrings.invalidUrlPattern) :
192
+ undefined)}>
193
+ <devtools-icon name="warning-filled" class="small warning-icon"
194
+ ?hidden=${Boolean(rule.urlPattern) && validPattern(rule.urlPattern)}></devtools-icon>
195
+ ${rule.urlPattern}
196
+ </td>
197
+ <td title=${ifDefined(
198
+ !rule.targetUrlTemplate ? i18nString(UIStrings.targetUrlTemplateCannotBeEmpty) :
199
+ !hasPlaceholder(rule.targetUrlTemplate) ? i18nString(UIStrings.templateRequiresPlaceholder) :
200
+ undefined)}>
201
+ <devtools-icon name="warning-filled" class="small warning-icon"
202
+ ?hidden=${Boolean(rule.targetUrlTemplate) && hasPlaceholder(rule.targetUrlTemplate)}></devtools-icon>
203
+ ${rule.targetUrlTemplate}
204
+ </td>
205
+ <td title=${ifDefined(!rule.label ? i18nString(UIStrings.labelCannotBeEmpty) : undefined)}>
206
+ <devtools-icon name="warning-filled" class="small warning-icon"
207
+ ?hidden=${Boolean(rule.label)}></devtools-icon>
208
+ ${rule.label}
209
+ </td>
210
+ </tr>
211
+ `;
212
+ })}
213
+ <tr placeholder></tr>
214
+ </tbody>
215
+ </table>
216
+ </devtools-data-grid>
217
+ ${input.rules.some(rule => !isRuleValid(rule)) ? html`
218
+ <div class="warning-footer">
219
+ <devtools-icon name="warning-filled" class="small"></devtools-icon>
220
+ <span>${i18nString(UIStrings.invalidRulesWarning)}</span>
221
+ </div>
222
+ ` : nothing}
223
+ </devtools-card>
224
+ <devtools-card heading=${i18nString(UIStrings.placeholderDocHeading)}>
225
+ <dl class="intro-section">
226
+ <div class="column-header">${i18nString(UIStrings.placeholderColumn)}</div>
227
+ <div class="column-header">${i18nString(UIStrings.headerColumn)}</div>
228
+ <dt class="placeholder">${'${devtoolsDebugId}'}</dt>
229
+ <dd class="source-header">Server-Timing: devtools-debug-id</dd>
230
+ <dd class="placeholder-description">${i18nString(UIStrings.devtoolsDebugIdDescription)}</dd>
231
+ <dt class="placeholder">${'${requestId}'}</dt>
232
+ <dd class="source-header">X-Request-ID</dd>
233
+ <dd class="placeholder-description">${i18nString(UIStrings.requestIdDescription)}</dd>
234
+ <dt class="placeholder">${'${correlationId}'}</dt>
235
+ <dd class="source-header">X-Correlation-ID / Correlation-ID</dd>
236
+ <dd class="placeholder-description">${i18nString(UIStrings.correlationIdDescription)}</dd>
237
+ <dt class="placeholder">${'${traceId}'}</dt>
238
+ <dd class="source-header">trace-id / Server-Timing: traceparent</dd>
239
+ <dd class="placeholder-description">${i18nString(UIStrings.traceIdDescription)}</dd>
240
+ <dt class="placeholder">${'${spanId}'}</dt>
241
+ <dd class="source-header">Server-Timing: traceparent</dd>
242
+ <dd class="placeholder-description">${i18nString(UIStrings.spanIdDescription)}</dd>
243
+ </dl>
244
+ </devtools-card>
245
+ </div>
246
+ </div>`,
247
+ // clang-format on
248
+ target);
249
+ };
250
+
251
+ export class BackendLinkingSettingsTab extends UI.Widget.VBox {
252
+ readonly #view: View;
253
+ readonly #rulesSetting: Common.Settings.Setting<NetworkForward.BackendLinking.BackendLinkingRule[]>;
254
+
255
+ constructor(target?: HTMLElement, view: View = DEFAULT_VIEW) {
256
+ super(target);
257
+ this.#view = view;
258
+ const res = Common.Settings.Settings.instance().maybeResolve(
259
+ NetworkForward.BackendLinking.backendLinkingRulesSettingDescriptor);
260
+ if (!('setting' in res)) {
261
+ throw new Error('Backend linking setting is not available');
262
+ }
263
+ this.#rulesSetting = res.setting;
264
+ }
265
+
266
+ override wasShown(): void {
267
+ super.wasShown();
268
+ this.#rulesSetting.addChangeListener(this.requestUpdate, this);
269
+ this.requestUpdate();
270
+ }
271
+
272
+ override willHide(): void {
273
+ super.willHide();
274
+ this.#rulesSetting.removeChangeListener(this.requestUpdate, this);
275
+ }
276
+
277
+ override performUpdate(): void {
278
+ const input: ViewInput = {
279
+ rules: this.#rulesSetting.get(),
280
+ onAddRule: rule => {
281
+ if (!isRuleValid(rule)) {
282
+ return;
283
+ }
284
+ this.#rulesSetting.set([...this.#rulesSetting.get(), rule]);
285
+ },
286
+ onUpdateRule: (oldRule, newRule) => {
287
+ if (!isRuleValid(newRule)) {
288
+ return;
289
+ }
290
+ const rules = [...this.#rulesSetting.get()];
291
+ const index = rules.indexOf(oldRule);
292
+ if (index !== -1) {
293
+ rules[index] = newRule;
294
+ this.#rulesSetting.set(rules);
295
+ }
296
+ },
297
+ onDeleteRule: rule => {
298
+ const rules = [...this.#rulesSetting.get()];
299
+ const index = rules.indexOf(rule);
300
+ if (index !== -1) {
301
+ rules.splice(index, 1);
302
+ this.#rulesSetting.set(rules);
303
+ }
304
+ },
305
+ };
306
+ this.#view(input, {}, this.contentElement);
307
+ }
308
+ }
@@ -0,0 +1,78 @@
1
+ /*
2
+ * Copyright 2026 The Chromium Authors
3
+ * Use of this source code is governed by a BSD-style license that can be
4
+ * found in the LICENSE file.
5
+ */
6
+
7
+ @scope to (devtools-widget > *) {
8
+ .settings-card-container {
9
+ align-items: stretch;
10
+ padding: 0 var(--sys-size-8);
11
+ }
12
+
13
+ devtools-card {
14
+ max-width: 100%;
15
+ }
16
+
17
+ .description-text {
18
+ color: var(--sys-color-on-surface-subtle);
19
+ font-size: var(--sys-typescale-body-medium-size);
20
+ line-height: var(--sys-typescale-body-medium-line-height);
21
+ margin: 0 0 var(--sys-size-5);
22
+ }
23
+
24
+ .intro-section {
25
+ display: grid;
26
+ grid-template-columns: max-content 1fr;
27
+ gap: var(--sys-size-2) var(--sys-size-6);
28
+ align-items: baseline;
29
+ font-size: var(--sys-typescale-body-small-size);
30
+ line-height: var(--sys-typescale-body-medium-line-height);
31
+ margin: 0;
32
+
33
+ dd {
34
+ margin: 0;
35
+ }
36
+
37
+ .column-header {
38
+ font-size: var(--sys-typescale-label-small-size);
39
+ font-weight: var(--ref-typeface-weight-medium);
40
+ border-bottom: 1px solid var(--sys-color-neutral-outline);
41
+ padding-bottom: var(--sys-size-2);
42
+ margin-bottom: var(--sys-size-3);
43
+ }
44
+
45
+ .placeholder,
46
+ .source-header {
47
+ font-family: var(--monospace-font-family);
48
+ }
49
+
50
+ .placeholder {
51
+ color: var(--sys-color-primary);
52
+ }
53
+
54
+ .placeholder-description {
55
+ grid-column: 1 / -1;
56
+ color: var(--sys-color-on-surface-subtle);
57
+ margin-bottom: var(--sys-size-6);
58
+ }
59
+ }
60
+
61
+ .warning-icon {
62
+ margin-right: var(--sys-size-3);
63
+ vertical-align: text-bottom;
64
+ }
65
+
66
+ td.editing .warning-icon {
67
+ display: none;
68
+ }
69
+
70
+ .warning-footer {
71
+ display: flex;
72
+ align-items: center;
73
+ gap: var(--sys-size-3);
74
+ color: var(--sys-color-on-surface-subtle);
75
+ font-size: var(--sys-typescale-body-small-size);
76
+ line-height: var(--sys-typescale-body-medium-line-height);
77
+ }
78
+ }