chrome-devtools-frontend 1.0.1682249 → 1.0.1684555

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 (103) hide show
  1. package/AUTHORS +1 -0
  2. package/front_end/core/sdk/ServiceWorkerCacheModel.ts +0 -7
  3. package/front_end/core/sdk/StorageBucketsModel.ts +0 -6
  4. package/front_end/entrypoints/inspector_main/InspectorMain.ts +2 -1
  5. package/front_end/entrypoints/inspector_main/inspector_main-meta.ts +1 -5
  6. package/front_end/entrypoints/main/MainImpl.ts +6 -4
  7. package/front_end/entrypoints/main/main-meta.ts +9 -51
  8. package/front_end/foundation/Universe.ts +7 -0
  9. package/front_end/generated/InspectorBackendCommands.ts +12 -22
  10. package/front_end/generated/protocol-mapping.d.ts +9 -59
  11. package/front_end/generated/protocol-proxy-api.d.ts +7 -47
  12. package/front_end/generated/protocol.ts +105 -330
  13. package/front_end/models/ai_assistance/AiAgent2.ts +12 -4
  14. package/front_end/models/ai_assistance/AiConversation.ts +25 -7
  15. package/front_end/models/ai_assistance/agents/AiAgent.ts +11 -19
  16. package/front_end/models/ai_assistance/agents/StorageAgent.ts +6 -6
  17. package/front_end/models/ai_assistance/ai_assistance.ts +4 -0
  18. package/front_end/models/ai_assistance/tools/GetLighthouseAudits.ts +12 -6
  19. package/front_end/models/ai_assistance/tools/GetStorageValues.ts +1 -1
  20. package/front_end/models/ai_assistance/tools/ListStorageKeys.ts +1 -1
  21. package/front_end/models/ai_assistance/tools/RunLighthouse.ts +5 -8
  22. package/front_end/models/ai_assistance/tools/Tool.ts +19 -6
  23. package/front_end/models/issues_manager/DOMIssuesManager.ts +144 -0
  24. package/front_end/models/issues_manager/ElementAccessibilityIssue.ts +13 -1
  25. package/front_end/models/issues_manager/GenericIssue.ts +14 -2
  26. package/front_end/models/issues_manager/IssuesManager.ts +0 -1
  27. package/front_end/models/issues_manager/issues_manager.ts +2 -0
  28. package/front_end/models/javascript_metadata/NativeFunctions.js +8 -0
  29. package/front_end/models/trace/Processor.ts +1 -0
  30. package/front_end/panels/ai_assistance/ExternalHandler.ts +89 -0
  31. package/front_end/panels/ai_assistance/ai_assistance.ts +1 -0
  32. package/front_end/panels/application/BackgroundServiceModel.ts +4 -3
  33. package/front_end/panels/application/IndexedDBModel.ts +0 -7
  34. package/front_end/panels/console/ConsoleView.ts +17 -16
  35. package/front_end/panels/console/ConsoleViewMessage.ts +4 -1
  36. package/front_end/panels/console/console-meta.ts +4 -19
  37. package/front_end/panels/elements/ElementIssueUtils.ts +10 -2
  38. package/front_end/panels/elements/ElementsPanel.ts +8 -3
  39. package/front_end/panels/elements/ElementsTreeElement.ts +82 -161
  40. package/front_end/panels/elements/ElementsTreeOutline.ts +26 -105
  41. package/front_end/panels/elements/StandaloneStylesContainer.ts +5 -11
  42. package/front_end/panels/elements/StylePropertyTreeElement.ts +2 -0
  43. package/front_end/panels/elements/StylesContainer.ts +1 -0
  44. package/front_end/panels/elements/StylesSidebarPane.ts +174 -151
  45. package/front_end/panels/network/RequestPayloadView.ts +5 -2
  46. package/front_end/panels/security/SecurityPanelSidebar.ts +0 -32
  47. package/front_end/panels/settings/KeybindsSettingsTab.ts +5 -2
  48. package/front_end/panels/sources/SourcesPanel.ts +6 -3
  49. package/front_end/panels/timeline/components/BreadcrumbsUI.ts +2 -6
  50. package/front_end/panels/timeline/components/CWVMetrics.ts +9 -10
  51. package/front_end/panels/timeline/components/DetailsView.ts +12 -16
  52. package/front_end/panels/timeline/components/ExportTraceOptions.ts +13 -13
  53. package/front_end/panels/timeline/components/FieldSettingsDialog.ts +19 -19
  54. package/front_end/panels/timeline/components/IgnoreListSetting.ts +7 -9
  55. package/front_end/panels/timeline/components/InteractionBreakdown.ts +3 -3
  56. package/front_end/panels/timeline/components/LayoutShiftDetails.ts +13 -13
  57. package/front_end/panels/timeline/components/LiveMetricsView.ts +64 -64
  58. package/front_end/panels/timeline/components/MetricCard.ts +25 -25
  59. package/front_end/panels/timeline/components/NetworkRequestDetails.ts +22 -22
  60. package/front_end/panels/timeline/components/NetworkRequestTooltip.ts +9 -9
  61. package/front_end/panels/timeline/components/OriginMap.ts +7 -7
  62. package/front_end/panels/timeline/components/RelatedInsightChips.ts +2 -2
  63. package/front_end/panels/timeline/components/SidebarAnnotationsTab.ts +19 -20
  64. package/front_end/panels/timeline/components/SidebarSingleInsightSet.ts +1 -1
  65. package/front_end/panels/timeline/components/TimelineSummary.ts +2 -2
  66. package/front_end/panels/timeline/components/Utils.ts +2 -6
  67. package/front_end/panels/timeline/components/insights/BaseInsightComponent.ts +6 -9
  68. package/front_end/panels/timeline/components/insights/Checklist.ts +2 -2
  69. package/front_end/panels/timeline/components/insights/Table.ts +1 -1
  70. package/front_end/third_party/chromium/README.chromium +1 -1
  71. package/front_end/ui/comments/CommentAnchorResolver.ts +94 -0
  72. package/front_end/ui/comments/CommentOverlayManager.ts +16 -32
  73. package/front_end/ui/components/text_editor/config.ts +2 -1
  74. package/front_end/ui/legacy/DockController.ts +4 -1
  75. package/front_end/ui/legacy/InspectorView.ts +3 -1
  76. package/front_end/ui/legacy/KeyboardShortcut.ts +4 -7
  77. package/front_end/ui/legacy/SearchableView.ts +2 -1
  78. package/front_end/ui/legacy/ShortcutRegistry.ts +6 -3
  79. package/front_end/ui/legacy/UIUtils.ts +10 -6
  80. package/front_end/ui/legacy/components/cookie_table/CookiesTable.ts +23 -24
  81. package/front_end/ui/legacy/components/perf_ui/BrickBreaker.ts +2 -2
  82. package/front_end/ui/legacy/components/perf_ui/FilmStripView.ts +6 -6
  83. package/front_end/ui/legacy/components/perf_ui/FlameChart.ts +14 -15
  84. package/front_end/ui/legacy/components/perf_ui/GCActionDelegate.ts +1 -1
  85. package/front_end/ui/legacy/components/perf_ui/NetworkPriorities.ts +5 -5
  86. package/front_end/ui/legacy/components/perf_ui/OverviewGrid.ts +5 -5
  87. package/front_end/ui/legacy/components/perf_ui/PieChart.ts +1 -1
  88. package/front_end/ui/legacy/components/perf_ui/perf_ui-meta.ts +4 -6
  89. package/front_end/ui/legacy/components/source_frame/FontView.ts +2 -2
  90. package/front_end/ui/legacy/components/source_frame/ImageView.ts +13 -13
  91. package/front_end/ui/legacy/components/source_frame/JSONView.ts +1 -1
  92. package/front_end/ui/legacy/components/source_frame/PreviewFactory.ts +2 -2
  93. package/front_end/ui/legacy/components/source_frame/ResourceSourceFrame.ts +1 -1
  94. package/front_end/ui/legacy/components/source_frame/SourceFrame.ts +15 -18
  95. package/front_end/ui/legacy/components/source_frame/XMLView.ts +1 -1
  96. package/front_end/ui/legacy/components/source_frame/source_frame-meta.ts +10 -10
  97. package/front_end/ui/legacy/theme_support/ThemeSupport.ts +5 -2
  98. package/front_end/ui/settings/ConsoleSettings.ts +32 -0
  99. package/front_end/ui/settings/InspectorMainSettings.ts +7 -0
  100. package/front_end/ui/settings/MainSettings.ts +80 -0
  101. package/front_end/ui/settings/settings.ts +4 -0
  102. package/front_end/ui/visual_logging/KnownContextValues.ts +8 -0
  103. package/package.json +1 -1
@@ -1046,14 +1046,18 @@ export function createHistoryInput(type = 'search', className?: string): HTMLInp
1046
1046
 
1047
1047
  function onKeydown(event: KeyboardEvent): void {
1048
1048
  if (event.keyCode === Keys.Up.code) {
1049
- historyPosition = Math.max(historyPosition - 1, 0);
1050
- historyInput.value = history[historyPosition];
1051
- historyInput.dispatchEvent(new Event('input', {bubbles: true, cancelable: true}));
1049
+ if (historyPosition > 0) {
1050
+ historyPosition--;
1051
+ historyInput.value = history[historyPosition];
1052
+ historyInput.dispatchEvent(new Event('input', {bubbles: true, cancelable: true}));
1053
+ }
1052
1054
  event.consume(true);
1053
1055
  } else if (event.keyCode === Keys.Down.code) {
1054
- historyPosition = Math.min(historyPosition + 1, history.length - 1);
1055
- historyInput.value = history[historyPosition];
1056
- historyInput.dispatchEvent(new Event('input', {bubbles: true, cancelable: true}));
1056
+ if (historyPosition < history.length - 1) {
1057
+ historyPosition++;
1058
+ historyInput.value = history[historyPosition];
1059
+ historyInput.dispatchEvent(new Event('input', {bubbles: true, cancelable: true}));
1060
+ }
1057
1061
  event.consume(true);
1058
1062
  } else if (event.keyCode === Keys.Enter.code) {
1059
1063
  if (history.length > 1 && history[history.length - 2] === historyInput.value) {
@@ -91,96 +91,95 @@ const {repeat, ifDefined} = Directives;
91
91
 
92
92
  const UIStrings = {
93
93
  /**
94
- * @description Cookie table cookies table expires session value in Cookies Table of the Cookies table in the Application panel
94
+ * @description Table cell text in the expires or max-age column indicating that the cookie expires at the end of the session.
95
95
  */
96
96
  session: 'Session',
97
97
  /**
98
- * @description Text for the name of something
98
+ * @description Header for the cookie name column in the cookies table.
99
99
  */
100
100
  name: 'Name',
101
101
  /**
102
- * @description Text for the value of something
102
+ * @description Header for the cookie value column in the cookies table.
103
103
  */
104
104
  value: 'Value',
105
105
  /**
106
- * @description Text for the size of something
106
+ * @description Header for the cookie size column in the cookies table.
107
107
  */
108
108
  size: 'Size',
109
109
  /**
110
- * @description Text for the "Domain" of the cookie
110
+ * @description Header for the cookie domain column in the cookies table.
111
111
  * https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#domaindomain-value
112
112
  */
113
113
  domain: 'Domain',
114
114
  /**
115
- * @description Text for the "Path" of the cookie
115
+ * @description Header for the cookie path column in the cookies table.
116
116
  * https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#pathpath-value
117
117
  */
118
118
  path: 'Path',
119
119
  /**
120
- * @description Text for the "Secure" property of the cookie
120
+ * @description Header for the secure attribute column in the cookies table.
121
121
  * https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#secure
122
122
  */
123
123
  secure: 'Secure',
124
124
  /**
125
- * @description Text for the "Partition Key Site" property of the cookie
125
+ * @description Header for the partition key site column in the cookies table.
126
126
  * https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#partitioned
127
127
  */
128
- partitionKeySite: 'Partition Key Site',
128
+ partitionKeySite: 'Partition key site',
129
129
  /**
130
- * @description Text for the "Priority" property of the cookie
131
- * Contains Low, Medium (default), or High if using deprecated cookie Priority attribute.
130
+ * @description Header for the priority attribute column in the cookies table. Contains Low, Medium (default), or High if using deprecated cookie Priority attribute.
132
131
  * https://bugs.chromium.org/p/chromium/issues/detail?id=232693
133
132
  */
134
133
  priority: 'Priority',
135
134
  /**
136
- * @description Data grid name for Editable Cookies data grid
135
+ * @description Accessible name for the editable cookies table.
137
136
  */
138
- editableCookies: 'Editable Cookies',
137
+ editableCookies: 'Editable cookies',
139
138
  /**
140
- * @description Text for web cookies
139
+ * @description Accessible name for the cookies table.
141
140
  */
142
141
  cookies: 'Cookies',
143
142
  /**
144
- * @description Text for something not available
143
+ * @description Table cell text indicating that a cookie property is not available.
145
144
  */
146
145
  na: 'N/A',
147
146
  /**
148
- * @description Text for Context Menu entry
147
+ * @description Context menu item in the cookies table to show network requests associated with the selected cookie.
149
148
  */
150
149
  showRequestsWithThisCookie: 'Show requests with this cookie',
151
150
  /**
152
- * @description Text for Context Menu entry
151
+ * @description Context menu item in the cookies table to show the issue associated with the selected cookie.
153
152
  */
154
153
  showIssueAssociatedWithThis: 'Show issue associated with this cookie',
155
154
  /**
156
- * @description Tooltip for the cell that shows the sourcePort property of a cookie in the cookie table. The source port is numberic attribute of a cookie.
155
+ * @description Tooltip text for the source port column cell in the cookies table. The source port is a numeric attribute indicating the port number (1-65535) on which the cookie was set, or -1 if unknown.
157
156
  */
158
157
  sourcePortTooltip:
159
158
  'Shows the source port (range 1-65535) the cookie was set on. If the port is unknown, this shows -1.',
160
159
  /**
161
- * @description Tooltip for the cell that shows the sourceScheme property of a cookie in the cookie table. The source scheme is a trinary attribute of a cookie.
160
+ * @description Tooltip text for the source scheme column cell in the cookies table. The source scheme is a trinary (three-state) attribute indicating whether the cookie was set on a secure scheme (`Secure`), non-secure scheme (`NonSecure`), or unset (`Unset`).
162
161
  */
163
162
  sourceSchemeTooltip:
164
163
  'Shows the source scheme (`Secure`, `NonSecure`) the cookie was set on. If the scheme is unknown, this shows `Unset`.',
165
164
  /**
166
- * @description Text for the date column displayed if the expiration time of the cookie is extremely far out in the future.
165
+ * @description Table cell text in the expires column when the expiration time of the cookie is in the far future.
167
166
  * @example {+275760-09-13T00:00:00.000Z} date
168
167
  */
169
168
  timeAfter: 'after {date}',
170
169
  /**
171
- * @description Tooltip for the date column displayed if the expiration time of the cookie is extremely far out in the future.
170
+ * @description Tooltip text in the expires column when the expiration time of the cookie is in the far future.
172
171
  * @example {+275760-09-13T00:00:00.000Z} date
173
172
  * @example {9001628746521180} seconds
174
173
  */
175
174
  timeAfterTooltip: 'The expiration timestamp is {seconds}, which corresponds to a date after {date}',
176
175
  /**
177
- * @description Text to be show in the Partition Key column in case it is an opaque origin.
176
+ * @description Table cell text in the partition key site column when the origin is opaque.
178
177
  */
179
178
  opaquePartitionKey: '(opaque)',
180
179
  /**
181
- * @description Tooltip for the disabled AI button on HttpOnly cookies, explaining why they cannot be debugged.
180
+ * @description Tooltip for the disabled AI button on HttpOnly cookies explaining why they cannot be added as context.
182
181
  */
183
- httpOnlyCookiesCannotBeAdded: 'HttpOnly cookies cannot be added as context',
182
+ httpOnlyCookiesCannotBeAdded: 'HttpOnly cookies can’t be added as context',
184
183
  } as const;
185
184
  const str_ = i18n.i18n.registerUIStrings('ui/legacy/components/cookie_table/CookiesTable.ts', UIStrings);
186
185
  const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
@@ -11,11 +11,11 @@ import type {FlameChart} from './FlameChart.js';
11
11
 
12
12
  const UIStrings = {
13
13
  /**
14
- * @description Message congratulating the user for having won a game.
14
+ * @description Message congratulating the user for winning the brick breaker game.
15
15
  */
16
16
  congrats: 'Congrats, you win!',
17
17
  /**
18
- * @description A Postscript hinting the user the possibility to open the game using a keycombo.
18
+ * @description Postscript message explaining how to open the brick breaker game using a keyboard shortcut.
19
19
  */
20
20
  ps: 'PS: You can also open the game by typing `fixme`',
21
21
  } as const;
@@ -14,24 +14,24 @@ import filmStripViewStyles from './filmStripView.css.js';
14
14
 
15
15
  const UIStrings = {
16
16
  /**
17
- * @description Element title in Film Strip View of the Performance panel
17
+ * @description Tooltip text for a screenshot frame in the film strip view of the Performance panel.
18
18
  */
19
- doubleclickToZoomImageClickTo: 'Doubleclick to zoom image. Click to view preceding requests.',
19
+ doubleclickToZoomImageClickTo: 'Double-click to zoom image. Click to view preceding requests.',
20
20
  /**
21
- * @description Aria label for captured screenshots in network panel.
21
+ * @description Accessible label for a screenshot frame in the film strip view of the Network panel.
22
22
  * @example {3ms} PH1
23
23
  */
24
24
  screenshotForSSelectToView: 'Screenshot for {PH1} - select to view preceding requests.',
25
25
  /**
26
- * @description Text for one or a group of screenshots
26
+ * @description Alt text for a screenshot thumbnail image in the film strip view.
27
27
  */
28
28
  screenshot: 'Screenshot',
29
29
  /**
30
- * @description Prev button title in Film Strip View of the Performance panel
30
+ * @description Tooltip text for the previous frame button in the film strip dialog.
31
31
  */
32
32
  previousFrame: 'Previous frame',
33
33
  /**
34
- * @description Next button title in Film Strip View of the Performance panel
34
+ * @description Tooltip text for the next frame button in the film strip dialog.
35
35
  */
36
36
  nextFrame: 'Next frame',
37
37
  } as const;
@@ -36,58 +36,57 @@ const SUBTITLE_FONT_SIZE_AND_STYLE = 'italic 10px';
36
36
 
37
37
  const UIStrings = {
38
38
  /**
39
- * @description Aria alert used to notify the user when an event has been selected because they tabbed into a group.
39
+ * @description Accessible announcement when an event is selected by tabbing into a group in the flame chart.
40
40
  * @example {Paint} PH1
41
41
  * @example {Main thread} PH2
42
- *
43
42
  */
44
- eventSelectedFromGroup: 'Selected a {PH1} event within {PH2}. Press enter to focus this event.',
43
+ eventSelectedFromGroup: 'Selected a {PH1} event within {PH2}. Press Enter to focus this event.',
45
44
  /**
46
- * @description Aria accessible name in Flame Chart of the Performance panel
45
+ * @description Accessible name for the flame chart canvas.
47
46
  */
48
- flameChart: 'Flame Chart',
47
+ flameChart: 'Flame chart',
49
48
  /**
50
- * @description Text for the screen reader to announce a hovered group
49
+ * @description Accessible announcement when hovering over a group in the flame chart.
51
50
  * @example {Network} PH1
52
51
  */
53
52
  sHovered: '{PH1} hovered',
54
53
  /**
55
- * @description Text for screen reader to announce a selected group.
54
+ * @description Accessible announcement when selecting a group in the flame chart.
56
55
  * @example {Network} PH1
57
56
  */
58
57
  sSelected: '{PH1} selected',
59
58
  /**
60
- * @description Text for screen reader to announce an expanded group
59
+ * @description Accessible announcement when expanding a group in the flame chart.
61
60
  * @example {Network} PH1
62
61
  */
63
62
  sExpanded: '{PH1} expanded',
64
63
  /**
65
- * @description Text for screen reader to announce a collapsed group
64
+ * @description Accessible announcement when collapsing a group in the flame chart.
66
65
  * @example {Network} PH1
67
66
  */
68
67
  sCollapsed: '{PH1} collapsed',
69
68
  /**
70
- * @description Text for an action that adds a label annotation to an entry in the Flame Chart
69
+ * @description Context menu option to add a label annotation to an entry in the flame chart.
71
70
  */
72
71
  labelEntry: 'Label entry',
73
72
  /**
74
- * @description Text for an action that adds link annotation between entries in the Flame Chart
73
+ * @description Context menu option to add a link annotation between entries in the flame chart.
75
74
  */
76
75
  linkEntries: 'Link entries',
77
76
  /**
78
- * @description Shown in the context menu when right clicking on a track header to enable the user to enter the track configuration mode.
77
+ * @description Context menu option to enter track configuration mode in the flame chart.
79
78
  */
80
79
  enterTrackConfigurationMode: 'Configure tracks',
81
80
  /**
82
- * @description Shown in the context menu when right clicking on a track header to allow the user to exit track configuration mode.
81
+ * @description Context menu option to exit track configuration mode in the flame chart.
83
82
  */
84
83
  exitTrackConfigurationMode: 'Finish configuring tracks',
85
84
  /**
86
- * @description Context menu option to copy the name of the track.
85
+ * @description Context menu option to copy the track name in the flame chart.
87
86
  */
88
87
  copyTrackName: 'Copy track name',
89
88
  /**
90
- * @description Context menu option to copy the URL of the track.
89
+ * @description Context menu option to copy the track URL in the flame chart.
91
90
  */
92
91
  copyTrackUrl: 'Copy track URL',
93
92
  } as const;
@@ -9,7 +9,7 @@ import type * as UI from '../../legacy.js';
9
9
 
10
10
  const UIStrings = {
11
11
  /**
12
- * @description Notification message shown to the user when garbage collection has completed.
12
+ * @description Notification message shown when garbage collection completes.
13
13
  */
14
14
  garbageCollectionCompleted: 'Garbage collection completed',
15
15
  } as const;
@@ -7,23 +7,23 @@ import * as Protocol from '../../../../generated/protocol.js';
7
7
 
8
8
  const UIStrings = {
9
9
  /**
10
- * @description Text in Network Priorities of the Performance panel
10
+ * @description Label for lowest network priority.
11
11
  */
12
12
  lowest: 'Lowest',
13
13
  /**
14
- * @description Text in Network Priorities of the Performance panel
14
+ * @description Label for low network priority.
15
15
  */
16
16
  low: 'Low',
17
17
  /**
18
- * @description Text in Network Priorities of the Performance panel
18
+ * @description Label for medium network priority.
19
19
  */
20
20
  medium: 'Medium',
21
21
  /**
22
- * @description Text in Network Priorities of the Performance panel
22
+ * @description Label for high network priority.
23
23
  */
24
24
  high: 'High',
25
25
  /**
26
- * @description Text in Network Priorities of the Performance panel
26
+ * @description Label for highest network priority.
27
27
  */
28
28
  highest: 'Highest',
29
29
  } as const;
@@ -16,17 +16,17 @@ import {TimelineGrid} from './TimelineGrid.js';
16
16
 
17
17
  const UIStrings = {
18
18
  /**
19
- * @description Label for the window for Overview grids
19
+ * @description Accessible label for the selection window in the overview grid.
20
20
  */
21
21
  overviewGridWindow: 'Overview grid window',
22
22
  /**
23
- * @description Label for left window resizer for Overview grids
23
+ * @description Accessible label for the left window resizer in the overview grid.
24
24
  */
25
- leftResizer: 'Left Resizer',
25
+ leftResizer: 'Left resizer',
26
26
  /**
27
- * @description Label for right window resizer for Overview grids
27
+ * @description Accessible label for the right window resizer in the overview grid.
28
28
  */
29
- rightResizer: 'Right Resizer',
29
+ rightResizer: 'Right resizer',
30
30
  } as const;
31
31
  const str_ = i18n.i18n.registerUIStrings('ui/legacy/components/perf_ui/OverviewGrid.ts', UIStrings);
32
32
  const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
@@ -11,7 +11,7 @@ import pieChartStyles from './pieChart.css.js';
11
11
 
12
12
  const UIStrings = {
13
13
  /**
14
- * @description Text for sum
14
+ * @description Label for the total sum in a pie chart legend.
15
15
  */
16
16
  total: 'Total',
17
17
  } as const;
@@ -10,21 +10,19 @@ import type * as PerfUI from './perf_ui.js';
10
10
 
11
11
  const UIStrings = {
12
12
  /**
13
- * @description Title of a setting under the Performance category in Settings.
14
- * Selected navigation allows switching between 2 different sets of shortcuts
15
- * and actions (like zoom on scroll or crtl/cmd + scroll) for navigating the performance panel.
13
+ * @description Title of a setting under the Performance category in Settings to select the navigation style for the Performance panel.
16
14
  */
17
15
  flamechartSelectedNavigation: 'Flamechart navigation:',
18
16
  /**
19
- * @description Modern navigation option in the Performance Panel.
17
+ * @description Setting option for modern flame chart navigation in the Performance panel.
20
18
  */
21
19
  modern: 'Modern',
22
20
  /**
23
- * @description Classic navigation option in the Performance Panel.
21
+ * @description Setting option for classic flame chart navigation in the Performance panel.
24
22
  */
25
23
  classic: 'Classic',
26
24
  /**
27
- * @description Title of an action in the components tool to collect garbage
25
+ * @description Action title to trigger garbage collection.
28
26
  */
29
27
  collectGarbage: 'Collect garbage',
30
28
  } as const;
@@ -41,11 +41,11 @@ import fontViewStyles from './fontView.css.js';
41
41
 
42
42
  const UIStrings = {
43
43
  /**
44
- * @description Text that appears on a button for the font resource type filter.
44
+ * @description Title of the font view tab in the Sources panel.
45
45
  */
46
46
  font: 'Font',
47
47
  /**
48
- * @description Aria accessible name in Font View of the Sources panel
48
+ * @description Accessible name for the font preview in the font view of the Sources panel.
49
49
  * @example {https://example.com} PH1
50
50
  */
51
51
  previewOfFontFromS: 'Preview of font from {PH1}',
@@ -45,46 +45,46 @@ import imageViewStyles from './imageView.css.js';
45
45
 
46
46
  const UIStrings = {
47
47
  /**
48
- * @description Text in Image View of the Sources panel
48
+ * @description Title of the image view tab in the Sources panel.
49
49
  */
50
50
  image: 'Image',
51
51
  /**
52
- * @description Text that appears when user drag and drop something (for example, a file) in Image View of the Sources panel
52
+ * @description Drop target message shown when dragging a file into the image view of the Sources panel.
53
53
  */
54
54
  dropImageFileHere: 'Drop image file here',
55
55
  /**
56
- * @description Text to indicate the source of an image
57
- * @example {example.com} PH1
56
+ * @description Alt text for the image preview in the image view of the Sources panel.
57
+ * @example {https://example.com} PH1
58
58
  */
59
59
  imageFromS: 'Image from {PH1}',
60
60
  /**
61
- * @description Text in Image View of the Sources panel
62
- * @example {2} PH1
63
- * @example {2} PH2
61
+ * @description Dimensions label in the toolbar of the image view showing width and height in pixels.
62
+ * @example {200} PH1
63
+ * @example {100} PH2
64
64
  */
65
65
  dD: '{PH1} × {PH2}',
66
66
  /**
67
- * @description A context menu item in the Image View of the Sources panel
67
+ * @description Context menu item in the image view of the Sources panel to copy the image URL.
68
68
  */
69
69
  copyImageUrl: 'Copy image URL',
70
70
  /**
71
- * @description A context menu item in the Image View of the Sources panel
71
+ * @description Context menu item in the image view of the Sources panel to copy the image as a data URI.
72
72
  */
73
73
  copyImageAsDataUri: 'Copy image as data URI',
74
74
  /**
75
- * @description A context menu item in the Image View of the Sources panel
75
+ * @description Context menu item in the image view of the Sources panel to open the image in a new tab.
76
76
  */
77
77
  openImageInNewTab: 'Open image in new tab',
78
78
  /**
79
- * @description A context menu item in the Image Preview
79
+ * @description Context menu item in the image view of the Sources panel to save the image.
80
80
  */
81
81
  saveImageAs: 'Save image as…',
82
82
  /**
83
- * @description The default file name when downloading a file
83
+ * @description Default file name used when saving an image with a data URI.
84
84
  */
85
85
  download: 'download',
86
86
  /**
87
- * @description Text indicating an image is too large to display and offering to open it in a new tab
87
+ * @description Link text shown in the image view of the Sources panel when an image is too large to display.
88
88
  */
89
89
  thisImageIsTooBig: 'This image is too big to display in DevTools. Click here to open it in a new tab.',
90
90
  } as const;
@@ -14,7 +14,7 @@ import jsonViewStyles from './jsonView.css.js';
14
14
 
15
15
  const UIStrings = {
16
16
  /**
17
- * @description Text to find an item
17
+ * @description Placeholder text for the search input in the json view.
18
18
  */
19
19
  find: 'Find',
20
20
  } as const;
@@ -16,11 +16,11 @@ import {XMLView} from './XMLView.js';
16
16
 
17
17
  const UIStrings = {
18
18
  /**
19
- * @description Text in Preview Factory of the Sources panel if the data to preview can't be shown due to an error
19
+ * @description Text shown in the empty widget when data fails to load in the preview factory of the Sources panel.
20
20
  */
21
21
  failedToLoadData: 'Failed to load data',
22
22
  /**
23
- * @description Text in Preview Factory of the Sources panel if there's no data to preview
23
+ * @description Text shown in the empty widget when there is no content to preview in the preview factory of the Sources panel.
24
24
  */
25
25
  nothingToPreview: 'Nothing to preview',
26
26
  } as const;
@@ -46,7 +46,7 @@ import {type RevealPosition, SourceFrameImpl, type SourceFrameOptions} from './S
46
46
 
47
47
  const UIStrings = {
48
48
  /**
49
- * @description Text to find an item
49
+ * @description Placeholder text for the search input in the resource source frame.
50
50
  */
51
51
  find: 'Find',
52
52
  } as const;
@@ -20,62 +20,60 @@ import * as UI from '../../legacy.js';
20
20
 
21
21
  const UIStrings = {
22
22
  /**
23
- * @description Text for the source of something
23
+ * @description Title of the source frame view tab.
24
24
  */
25
25
  source: 'Source',
26
26
  /**
27
- * @description Text to pretty print a file
27
+ * @description Tooltip text for the pretty print button in the toolbar.
28
28
  */
29
29
  prettyPrint: 'Pretty print',
30
30
  /**
31
- * @description Text when something is loading
31
+ * @description Tooltip text for the progress indicator while content is loading in the source frame.
32
32
  */
33
33
  loading: 'Loading…',
34
34
  /**
35
- * @description Text when a file is currently being pretty printed/formatted in the editor
35
+ * @description Placeholder text shown in the editor while formatting content.
36
36
  */
37
37
  formatting: 'Formatting…',
38
38
  /**
39
- * @description Shown at the bottom of the Sources panel when the user has made multiple
40
- * simultaneous text selections in the text editor.
39
+ * @description Status bar text in the source frame showing the number of active selection regions.
41
40
  * @example {2} PH1
42
41
  */
43
42
  dSelectionRegions: '{PH1} selection regions',
44
43
  /**
45
- * @description Position indicator in Source Frame of the Sources panel. The placeholder is a
46
- * hexadecimal number value, which is why it is prefixed with '0x'.
44
+ * @description Status bar text in the source frame showing the current bytecode offset position. The placeholder is a hexadecimal number value, which is why it is prefixed with '0x'.
47
45
  * @example {abc} PH1
48
46
  */
49
47
  bytecodePositionXs: 'Bytecode position `0x`{PH1}',
50
48
  /**
51
- * @description Text in Source Frame of the Sources panel
49
+ * @description Status bar text in the source frame showing the cursor line and column position.
52
50
  * @example {2} PH1
53
51
  * @example {2} PH2
54
52
  */
55
- lineSColumnS: 'Line {PH1}, Column {PH2}',
53
+ lineSColumnS: 'Line {PH1}, column {PH2}',
56
54
  /**
57
- * @description Text in Source Frame of the Sources panel
55
+ * @description Status bar text in the source frame showing the number of characters selected.
58
56
  * @example {2} PH1
59
57
  */
60
58
  dCharactersSelected: '{PH1} characters selected',
61
59
  /**
62
- * @description Text in Source Frame of the Sources panel
60
+ * @description Status bar text in the source frame showing the number of lines and characters selected.
63
61
  * @example {2} PH1
64
62
  * @example {2} PH2
65
63
  */
66
64
  dLinesDCharactersSelected: '{PH1} lines, {PH2} characters selected',
67
65
  /**
68
- * @description Headline of warning shown to users when pasting text/code into DevTools.
66
+ * @description Title of warning dialog shown to users when pasting code into DevTools.
69
67
  */
70
68
  doYouTrustThisCode: 'Do you trust this code?',
71
69
  /**
72
- * @description Warning shown to users when pasting text/code into DevTools. IMPORTANT: keep double quotes around PH1 and do not use single quotes.
70
+ * @description Warning message shown to users when pasting code into DevTools. IMPORTANT: keep double quotes around PH1 and do not use single quotes.
73
71
  * @example {allow pasting} PH1
74
72
  */
75
73
  doNotPaste:
76
- 'Don’t paste code you do not understand or have not reviewed yourself into DevTools. This could allow attackers to steal your identity or take control of your computer. Please type "{PH1}" below to allow pasting.',
74
+ 'Don’t paste code you don’t understand or haven’t reviewed yourself into DevTools. This could allow attackers to steal your identity or take control of your computer. Type "{PH1}" below to allow pasting.',
77
75
  /**
78
- * @description Text a user needs to type in order to confirm that they are aware of the danger of pasting code into the DevTools console.
76
+ * @description Text the user needs to type to confirm they want to paste code into DevTools.
79
77
  */
80
78
  allowPasting: 'allow pasting',
81
79
  /**
@@ -84,8 +82,7 @@ const UIStrings = {
84
82
  */
85
83
  typeAllowPasting: 'Type "{PH1}"',
86
84
  /**
87
- * @description Error message shown when the user tries to open a file that contains non-readable data. "Editor" refers to
88
- * a text editor.
85
+ * @description Error message shown in the text editor when binary data cannot be displayed.
89
86
  */
90
87
  binaryContentError:
91
88
  'Editor can’t show binary data. Use the Response tab in the Network panel to inspect this resource.',
@@ -15,7 +15,7 @@ import xmlViewStyles from './xmlView.css.js';
15
15
 
16
16
  const UIStrings = {
17
17
  /**
18
- * @description Text to find an item
18
+ * @description Placeholder text for the search input in the xml view.
19
19
  */
20
20
  find: 'Find',
21
21
  } as const;