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
@@ -45,164 +45,164 @@ const RTT_MINIMUM = 60;
45
45
 
46
46
  const UIStrings = {
47
47
  /**
48
- * @description Label of a badge/pill indicating that the metrics are for a soft navigation.
48
+ * @description Badge label indicating that the metrics are for a soft navigation in the Performance panel.
49
49
  */
50
50
  softNavigationPillText: 'SOFT NAV',
51
51
  /**
52
- * @description Title of a view that shows performance metrics from the local environment and field metrics collected from real users. "field metrics" should be interpreted as "real user metrics".
52
+ * @description Title of a view that shows performance metrics from the local environment and field metrics collected from real users in the Performance panel.
53
53
  */
54
54
  localAndFieldMetrics: 'Local and field metrics',
55
55
  /**
56
- * @description Title of a view that shows performance metrics from the local environment.
56
+ * @description Title of a view that shows performance metrics from the local environment in the Performance panel.
57
57
  */
58
58
  localMetrics: 'Local metrics',
59
59
  /**
60
- *@description Text for the link to the historical field data for the specific URL or origin that is shown. This link text appears in parenthesis after the collection period information in the field data dialog. The link opens the CrUX Vis viewer (https://cruxvis.withgoogle.com).
60
+ * @description Link text to historical field data in the Performance panel.
61
61
  */
62
62
  fieldDataHistoryLink: 'View history',
63
63
  /**
64
- *@description Tooltip for the CrUX Vis viewer link which shows the history of the field data for the specific URL or origin.
64
+ * @description Tooltip for the link to historical field data in the Performance panel.
65
65
  */
66
66
  fieldDataHistoryTooltip: 'View field data history in CrUX Vis',
67
67
  /**
68
- * @description Accessible label for a section that logs user interactions and layout shifts. A layout shift is an event that shifts content in the layout of the page causing a jarring experience for the user.
68
+ * @description Accessible label for the section that logs user interactions and layout shifts in the Performance panel.
69
69
  */
70
70
  eventLogs: 'Interaction and layout shift logs section',
71
71
  /**
72
- * @description Title of a section that lists user interactions.
72
+ * @description Section title for user interactions in the live metrics view of the Performance panel.
73
73
  */
74
74
  interactions: 'Interactions',
75
75
  /**
76
- * @description Title of a section that lists layout shifts. A layout shift is an event that shifts content in the layout of the page causing a jarring experience for the user.
76
+ * @description Section title for layout shifts in the live metrics view of the Performance panel.
77
77
  */
78
78
  layoutShifts: 'Layout shifts',
79
79
  /**
80
- * @description Title of a sidebar section that shows options for the user to take after using the main view.
80
+ * @description Title of a sidebar section that shows next step options in the Performance panel.
81
81
  */
82
82
  nextSteps: 'Next steps',
83
83
  /**
84
- * @description Title of a section that shows options for how real user data in the field should be fetched. This should be interpreted as "Real user data".
84
+ * @description Section title for field metrics in the live metrics view of the Performance panel.
85
85
  */
86
86
  fieldMetricsTitle: 'Field metrics',
87
87
  /**
88
- * @description Title of a section that shows settings to control the developers local testing environment.
88
+ * @description Section title for local environment settings in the live metrics view of the Performance panel.
89
89
  */
90
90
  environmentSettings: 'Environment settings',
91
91
  /**
92
- * @description Label for an select box that selects which device type field metrics be shown for (e.g. desktop/mobile/all devices/etc). "field metrics" should be interpreted as "real user data".
92
+ * @description Label for a select dropdown to choose the device type for field metrics in the Performance panel.
93
93
  * @example {Mobile} PH1
94
94
  */
95
95
  showFieldDataForDevice: 'Show field metrics for device type: {PH1}',
96
96
  /**
97
- * @description Text indicating that there is not enough data to report real user statistics.
97
+ * @description Text indicating that there is not enough data to report real user statistics in the Performance panel.
98
98
  */
99
99
  notEnoughData: 'Not enough data',
100
100
  /**
101
- * @description Label for a text block that describes the network connections of real users.
101
+ * @description Label for real user network conditions in the live metrics view of the Performance panel.
102
102
  * @example {75th percentile is similar to Slow 4G throttling} PH1
103
103
  */
104
104
  network: 'Network: {PH1}',
105
105
  /**
106
- * @description Label for an select box that selects which device type real user data should be shown for (e.g. desktop/mobile/all devices/etc).
106
+ * @description Label for a select dropdown to choose the device form factor in the Performance panel.
107
107
  * @example {Mobile} PH1
108
108
  */
109
109
  device: 'Device: {PH1}',
110
110
  /**
111
- * @description Label for an option to select all device form factors.
111
+ * @description Label for an option to select all device form factors in the Performance panel.
112
112
  */
113
113
  allDevices: 'All devices',
114
114
  /**
115
- * @description Label for an option to select the desktop form factor.
115
+ * @description Label for an option to select the desktop form factor in the Performance panel.
116
116
  */
117
117
  desktop: 'Desktop',
118
118
  /**
119
- * @description Label for an option to select the mobile form factor.
119
+ * @description Label for an option to select the mobile form factor in the Performance panel.
120
120
  */
121
121
  mobile: 'Mobile',
122
122
  /**
123
- * @description Label for an option to select the tablet form factor.
123
+ * @description Label for an option to select the tablet form factor in the Performance panel.
124
124
  */
125
125
  tablet: 'Tablet',
126
126
  /**
127
- * @description Label for an option to to automatically select the form factor. The automatic selection will be displayed in PH1.
127
+ * @description Label for an option to automatically select the form factor in the Performance panel.
128
128
  * @example {Desktop} PH1
129
129
  */
130
130
  auto: 'Auto ({PH1})',
131
131
  /**
132
- * @description Label for an option that is loading.
132
+ * @description Label for an option that is currently loading in the Performance panel.
133
133
  * @example {Desktop} PH1
134
134
  */
135
135
  loadingOption: '{PH1} - Loading…',
136
136
  /**
137
- * @description Label for an option that does not have enough data and the user should ignore.
137
+ * @description Label for an option that lacks enough data in the Performance panel.
138
138
  * @example {Desktop} PH1
139
139
  */
140
140
  needsDataOption: '{PH1} - No data',
141
141
  /**
142
- * @description Label for an option that selects the page's specific URL as opposed to it's entire origin/domain.
142
+ * @description Label for an option that selects the page specific URL in the Performance panel.
143
143
  */
144
144
  urlOption: 'URL',
145
145
  /**
146
- * @description Label for an option that selects the page's entire origin/domain as opposed to it's specific URL.
146
+ * @description Label for an option that selects the entire origin in the Performance panel.
147
147
  */
148
148
  originOption: 'Origin',
149
149
  /**
150
- * @description Label for an option that selects the page's specific URL as opposed to it's entire origin/domain.
150
+ * @description Label for an option that selects the specific URL with the URL displayed in the Performance panel.
151
151
  * @example {https://example.com/} PH1
152
152
  */
153
153
  urlOptionWithKey: 'URL: {PH1}',
154
154
  /**
155
- * @description Label for an option that selects the page's entire origin/domain as opposed to it's specific URL.
155
+ * @description Label for an option that selects the entire origin with the origin displayed in the Performance panel.
156
156
  * @example {https://example.com} PH1
157
157
  */
158
158
  originOptionWithKey: 'Origin: {PH1}',
159
159
  /**
160
- * @description Label for an combo-box that indicates if field metrics should be taken from the page's URL or it's origin/domain. "field metrics" should be interpreted as "real user data".
160
+ * @description Label for a dropdown indicating whether field metrics are shown for the URL or origin in the Performance panel.
161
161
  * @example {Origin: https://example.com} PH1
162
162
  */
163
163
  showFieldDataForPage: 'Show field metrics for {PH1}',
164
164
  /**
165
- * @description Tooltip text explaining that real user connections are similar to a test environment with no throttling. "throttling" is when the network is intentionally slowed down to simulate a slower connection.
165
+ * @description Tooltip text explaining that real user connections are too fast to simulate with network throttling in the Performance panel.
166
166
  */
167
167
  tryDisablingThrottling: '75th percentile is too fast to simulate with throttling',
168
168
  /**
169
- * @description Tooltip text explaining that real user connections are similar to a specif network throttling setup. "throttling" is when the network is intentionally slowed down to simulate a slower connection.
169
+ * @description Tooltip text explaining that real user connections are similar to a specific network throttling preset in the Performance panel.
170
170
  * @example {Slow 4G} PH1
171
171
  */
172
172
  tryUsingThrottling: '75th percentile is similar to {PH1} throttling',
173
173
  /**
174
- * @description Text block listing what percentage of real users are on different device form factors.
174
+ * @description Text block listing the distribution of real users across device form factors in the Performance panel.
175
175
  * @example {60%} PH1
176
176
  * @example {30%} PH2
177
177
  */
178
178
  percentDevices: '{PH1}% mobile, {PH2}% desktop',
179
179
  /**
180
- * @description Text block explaining how to simulate different mobile and desktop devices.
180
+ * @description Text block explaining how to simulate different mobile and desktop devices in the Performance panel.
181
181
  */
182
182
  useDeviceToolbar:
183
183
  'Use the [device toolbar](https://developer.chrome.com/docs/devtools/device-mode) and configure throttling to simulate real user environments and identify more performance issues.',
184
184
  /**
185
- * @description Text label for a checkbox that controls if the network cache is disabled.
185
+ * @description Checkbox label that controls if the network cache is disabled in the Performance panel.
186
186
  */
187
187
  disableNetworkCache: 'Disable network cache',
188
188
  /**
189
- * @description Text label for a selection box showing which CPU throttling option is applied.
189
+ * @description Label for the CPU throttling dropdown in the live metrics view of the Performance panel.
190
190
  */
191
191
  cpuThrottling: 'CPU:',
192
192
  /**
193
- * @description Text label for a link to the Largest Contentful Paint (LCP) related page element. This element represents the largest content on the page. "LCP" should not be translated.
193
+ * @description Link label to the Largest Contentful Paint (LCP) page element in the live metrics view of the Performance panel.
194
194
  */
195
195
  lcpElement: 'LCP element',
196
196
  /**
197
- * @description Text label for a button that reveals the user interaction associated with the Interaction to Next Paint (INP) performance metric. "INP" should not be translated.
197
+ * @description Button label to reveal the user interaction associated with INP in the live metrics view of the Performance panel.
198
198
  */
199
199
  inpInteractionLink: 'INP interaction',
200
200
  /**
201
- * @description Text label for a button that reveals the cluster of layout shift events that affected the page content the most. A cluster is a group of layout shift events that occur in quick succession.
201
+ * @description Button label to reveal the worst layout shift cluster in the live metrics view of the Performance panel.
202
202
  */
203
203
  worstCluster: 'Worst cluster',
204
204
  /**
205
- * @description [ICU Syntax] Text content of a button that reveals the cluster of layout shift events that affected the page content the most. A layout shift is an event that shifts content in the layout of the page causing a jarring experience for the user. This text will indicate how many shifts were in the cluster.
205
+ * @description [ICU Syntax] Button label indicating the number of shifts in the worst layout shift cluster in the live metrics view of the Performance panel.
206
206
  * @example {3} shiftCount
207
207
  */
208
208
  numShifts: `{shiftCount, plural,
@@ -210,105 +210,105 @@ const UIStrings = {
210
210
  other {{shiftCount} shifts}
211
211
  }`,
212
212
  /**
213
- * @description Label for a a range of dates that represents the period of time a set of field metrics is collected from.
213
+ * @description Label for the date range representing the collection period for field metrics in the Performance panel.
214
214
  * @example {Oct 1, 2024 - Nov 1, 2024} PH1
215
215
  */
216
216
  collectionPeriod: 'Collection period: {PH1}',
217
217
  /**
218
- * @description Text showing a range of dates meant to represent a period of time.
218
+ * @description Date range format string in the live metrics view of the Performance panel.
219
219
  * @example {Oct 1, 2024} PH1
220
220
  * @example {Nov 1, 2024} PH2
221
221
  */
222
222
  dateRange: '{PH1} - {PH2}',
223
223
  /**
224
- * @description Text block telling the user to see how performance metrics measured on their local computer compare to data collected from real users. PH1 will be a link to more information about the Chrome UX Report and the link text will be untranslated because it is a product name.
224
+ * @description Text banner explaining how to compare local metrics to real user data in the Performance panel.
225
225
  * @example {Chrome UX Report} PH1
226
226
  */
227
227
  seeHowYourLocalMetricsCompare: 'See how your local metrics compare to real user data in the {PH1}.',
228
228
  /**
229
- * @description Text for a link that goes to more documentation about local and field metrics. "Local" refers to performance metrics measured in the developers local environment. "field metrics" should be interpreted as "real user data".
229
+ * @description Link text for documentation about local and field metrics in the Performance panel.
230
230
  */
231
231
  localFieldLearnMoreLink: 'Learn more about local and field metrics',
232
232
  /**
233
- * @description Tooltip text for a link that goes to documentation explaining the difference between local and field metrics. "Local metrics" are performance metrics measured in the developers local environment. "field metrics" should be interpreted as "real user data".
233
+ * @description Tooltip text explaining the difference between local and field metrics in the Performance panel.
234
234
  */
235
235
  localFieldLearnMoreTooltip:
236
- 'Local metrics are captured from the current page using your network connection and device. field metrics is measured by real users using many different network connections and devices.',
236
+ 'Local metrics are captured from the current page using your network connection and device. Field metrics are measured by real users using many different network connections and devices.',
237
237
  /**
238
- * @description Tooltip text explaining that this user interaction was ignored when calculating the Interaction to Next Paint (INP) metric because the interaction delay fell beyond the 98th percentile of interaction delays on this page. "INP" is an acronym and should not be translated.
238
+ * @description Tooltip text explaining why an interaction was excluded from the INP calculation in the Performance panel.
239
239
  */
240
240
  interactionExcluded:
241
241
  'INP is calculated using the 98th percentile of interaction delays, so some interaction delays may be larger than the INP value.',
242
242
  /**
243
- * @description Tooltip for a button that will remove everything from the currently selected log.
243
+ * @description Tooltip for the button to clear the currently selected log in the live metrics view of the Performance panel.
244
244
  */
245
- clearCurrentLog: 'Clear the current log',
245
+ clearCurrentLog: 'Clear current log',
246
246
  /**
247
- * @description Title for a page load subpart that measures the time between when the page load starts and the time when the first byte of the initial document is downloaded.
247
+ * @description Label for the time to first byte subpart in the live metrics view of the Performance panel.
248
248
  */
249
249
  timeToFirstByte: 'Time to first byte',
250
250
  /**
251
- * @description Title for a page load subpart that measures the time between when the first byte of the initial document is downloaded and when the request for the largest image content starts.
251
+ * @description Label for the resource load delay subpart in the live metrics view of the Performance panel.
252
252
  */
253
253
  resourceLoadDelay: 'Resource load delay',
254
254
  /**
255
- * @description Title for a page load subpart that measures the time between when the request for the largest image content starts and when it finishes.
255
+ * @description Label for the resource load duration subpart in the live metrics view of the Performance panel.
256
256
  */
257
257
  resourceLoadDuration: 'Resource load duration',
258
258
  /**
259
- * @description Title for a page load subpart that measures the time between when the request for the largest image content finishes and when the largest image element is rendered on the page.
259
+ * @description Label for the element render delay subpart in the live metrics view of the Performance panel.
260
260
  */
261
261
  elementRenderDelay: 'Element render delay',
262
262
  /**
263
- * @description Title for a subpart during a user interaction that measures the time between when the interaction starts and when the browser starts running interaction handlers.
263
+ * @description Label for the input delay subpart of an interaction in the live metrics view of the Performance panel.
264
264
  */
265
265
  inputDelay: 'Input delay',
266
266
  /**
267
- * @description Title for a subpart during a user interaction that measures the time between when the browser starts running interaction handlers and when the browser finishes running interaction handlers.
267
+ * @description Label for the processing duration subpart of an interaction in the live metrics view of the Performance panel.
268
268
  */
269
269
  processingDuration: 'Processing duration',
270
270
  /**
271
- * @description Title for a subpart during a user interaction that measures the time between when the browser finishes running interaction handlers and when the browser renders the next visual frame that shows the result of the interaction.
271
+ * @description Label for the presentation delay subpart of an interaction in the live metrics view of the Performance panel.
272
272
  */
273
273
  presentationDelay: 'Presentation delay',
274
274
  /**
275
- * @description Tooltip text for a status chip in a list of user interactions that indicates if the associated interaction is the interaction used in the Interaction to Next Paint (INP) performance metric because it's interaction delay is at the 98th percentile.
275
+ * @description Tooltip text for an interaction status chip indicating that it represents the 98th percentile INP interaction in the Performance panel.
276
276
  */
277
277
  inpInteraction: 'The INP interaction is at the 98th percentile of interaction delays.',
278
278
  /**
279
- * @description Tooltip text for a button that reveals the user interaction associated with the Interaction to Next Paint (INP) performance metric.
279
+ * @description Tooltip text for the button to reveal the INP interaction in the live metrics view of the Performance panel.
280
280
  */
281
281
  showInpInteraction: 'Go to the INP interaction.',
282
282
  /**
283
- * @description Tooltip text for a button that reveals the cluster of layout shift events that affected the page content the most. A layout shift is an event that shifts content in the layout of the page causing a jarring experience for the user. A cluster is a group of layout shift events that occur in quick succession.
283
+ * @description Tooltip text for the button to reveal the worst layout shift cluster in the live metrics view of the Performance panel.
284
284
  */
285
285
  showClsCluster: 'Go to worst layout shift cluster.',
286
286
  /**
287
- * @description Column header for table cell values representing the subpart/component/stage/section of a larger duration.
287
+ * @description Table column header for subpart stage names in the live metrics view of the Performance panel.
288
288
  */
289
289
  subpart: 'Subpart',
290
290
  /**
291
- * @description Column header for table cell values representing a subpart duration (in milliseconds) that was measured in the developers local environment.
291
+ * @description Table column header for local duration values in milliseconds in the live metrics view of the Performance panel.
292
292
  */
293
293
  duration: 'Local duration (ms)',
294
294
  /**
295
- * @description Tooltip text for a button that will open the Chrome DevTools console to and log additional details about a user interaction.
295
+ * @description Tooltip text for the button to log interaction details to the console in the live metrics view of the Performance panel.
296
296
  */
297
- logToConsole: 'Log additional interaction data to the console',
297
+ logToConsole: 'Log more interaction data to the console',
298
298
  /**
299
- * @description Title of a view that can be used to analyze the performance of a Node process as a timeline. "Node" is a product name and should not be translated.
299
+ * @description Section title for Node process performance in the Performance panel.
300
300
  */
301
301
  nodePerformanceTimeline: 'Node performance',
302
302
  /**
303
- * @description Description of a view that can be used to analyze the performance of a Node process as a timeline. "Node" is a product name and should not be translated.
303
+ * @description Description text for recording a performance timeline of a connected Node process in the Performance panel.
304
304
  */
305
305
  nodeClickToRecord: 'Record a performance timeline of the connected Node process.',
306
306
  /**
307
- * @description Text in Timeline Panel of the Performance panel for network throttling
307
+ * @description Label for the network throttling dropdown in the live metrics view of the Performance panel.
308
308
  */
309
309
  networkThrottling: 'Network:',
310
310
  /**
311
- * @description Text for why user should change a throttling setting.
311
+ * @description Tooltip text explaining why the user should adjust throttling settings in the Performance panel.
312
312
  */
313
313
  recommendedThrottlingReason: 'Consider changing setting to simulate real user environments',
314
314
  } as const;
@@ -31,113 +31,113 @@ const {html, nothing} = Lit;
31
31
 
32
32
  const UIStrings = {
33
33
  /**
34
- * @description Label for a metric value that was measured in the local environment.
34
+ * @description Label for a metric value measured in the local environment in the live metrics view of the Performance panel.
35
35
  */
36
36
  localValue: 'Local',
37
37
  /**
38
- * @description Label for the 75th percentile of a metric according to data collected from real users in the field. This should be interpreted as "75th percentile of real users".
38
+ * @description Label for the 75th percentile of real user field metrics in the live metrics view of the Performance panel.
39
39
  */
40
40
  field75thPercentile: 'Field 75th percentile',
41
41
  /**
42
- * @description Column header for the 75th percentile of a metric according to data collected from real users in the field. This should be interpreted as "75th percentile of real users". Width of the column is limited so character length should be as small as possible.
42
+ * @description Column header for the 75th percentile field metrics in the live metrics view of the Performance panel.
43
43
  */
44
44
  fieldP75: 'Field p75',
45
45
  /**
46
- * @description Text label for values that are classified as "good".
46
+ * @description Label for metric values classified as good in the live metrics view of the Performance panel.
47
47
  */
48
48
  good: 'Good',
49
49
  /**
50
- * @description Text label for values that are classified as "needs improvement".
50
+ * @description Label for metric values classified as needs improvement in the live metrics view of the Performance panel.
51
51
  */
52
52
  needsImprovement: 'Needs improvement',
53
53
  /**
54
- * @description Text label for values that are classified as "poor".
54
+ * @description Label for metric values classified as poor in the live metrics view of the Performance panel.
55
55
  */
56
56
  poor: 'Poor',
57
57
  /**
58
- * @description Text label for a range of values that are less than or equal to a certain value.
58
+ * @description Label for a range of values that are less than or equal to a threshold in the live metrics view of the Performance panel.
59
59
  * @example {500 ms} PH1
60
60
  */
61
61
  leqRange: '(≤{PH1})',
62
62
  /**
63
- * @description Text label for a range of values that are between two values.
63
+ * @description Label for a range of values between two thresholds in the live metrics view of the Performance panel.
64
64
  * @example {500 ms} PH1
65
65
  * @example {800 ms} PH2
66
66
  */
67
67
  betweenRange: '({PH1}-{PH2})',
68
68
  /**
69
- * @description Text label for a range of values that are greater than a certain value.
69
+ * @description Label for a range of values greater than a threshold in the live metrics view of the Performance panel.
70
70
  * @example {500 ms} PH1
71
71
  */
72
72
  gtRange: '(>{PH1})',
73
73
  /**
74
- * @description Text for a percentage value in the live metrics view.
74
+ * @description Percentage value format string in the live metrics view of the Performance panel.
75
75
  * @example {13} PH1
76
76
  */
77
77
  percentage: '{PH1}%',
78
78
  /**
79
- * @description Text instructing the user to interact with the page because a user interaction is required to measure Interaction to Next Paint (INP).
79
+ * @description Prompt instructing the user to interact with the page to measure INP in the live metrics view of the Performance panel.
80
80
  */
81
81
  interactToMeasure: 'Interact with the page to measure INP.',
82
82
  /**
83
- * @description Label for a tooltip that provides more details.
83
+ * @description Tooltip label to expand more details in the metric card of the Performance panel.
84
84
  */
85
85
  viewCardDetails: 'View card details',
86
86
  /**
87
- * @description Text block recommending a site developer look at their test environment followed by bullet points that highlight specific things about the test environment. "local" refers to the testing setup of the developer as opposed to the conditions experienced by real users.
87
+ * @description Header recommending the user inspect their local test environment in the live metrics view of the Performance panel.
88
88
  */
89
89
  considerTesting: 'Consider your local test conditions',
90
90
  /**
91
- * @description Text block explaining how network conditions can slow down the page load. "network throttling" refers to artificially slowing down the network to simulate slower network conditions.
91
+ * @description Recommendation explaining how network throttling affects LCP page loads in the Performance panel.
92
92
  */
93
93
  recThrottlingLCP:
94
94
  'Real users may experience longer page loads due to slower network conditions. Increasing network throttling will simulate slower network conditions.',
95
95
  /**
96
- * @description Text block explaining how CPU speed affects how long it takes the page to render after an interaction. "CPU throttling" refers to artificially slowing down the CPU to simulate slower devices.
96
+ * @description Recommendation explaining how CPU throttling affects INP interaction delays in the Performance panel.
97
97
  */
98
98
  recThrottlingINP:
99
99
  'Real users may experience longer interactions due to slower CPU speeds. Increasing CPU throttling will simulate a slower device.',
100
100
  /**
101
- * @description Text block explaining how screen size can affect what content is rendered and therefore affects the LCP performance metric. "viewport" and "screen size" are synonymous in this case. "LCP element" refers to the page element that was the largest content on the page.
101
+ * @description Recommendation explaining how viewport size affects the LCP element in the Performance panel.
102
102
  */
103
103
  recViewportLCP: 'Screen size can influence what the LCP element is. Ensure you are testing common viewport sizes.',
104
104
  /**
105
- * @description Text block explaining viewport size can affect layout shifts. "viewport" and "screen size" are synonymous in this case. "layout shifts" refer to page instability where content moving around can create a jarring experience.
105
+ * @description Recommendation explaining how viewport size affects layout shifts in the Performance panel.
106
106
  */
107
107
  recViewportCLS: 'Screen size can influence what layout shifts happen. Ensure you are testing common viewport sizes.',
108
108
  /**
109
- * @description Text block explaining how a user interacts with the page can cause different amounts of layout shifts. "layout shifts" refer to page instability where content moving around can create a jarring experience.
109
+ * @description Recommendation explaining how user interaction journeys affect layout shifts in the Performance panel.
110
110
  */
111
111
  recJourneyCLS:
112
112
  'How a user interacts with the page can influence layout shifts. Ensure you are testing common interactions like scrolling the page.',
113
113
  /**
114
- * @description Text block explaining how a user interacts with the page can affect interaction delays. "interaction delay" refers to the delay between an interaction and the page rendering new content.
114
+ * @description Recommendation explaining how user interaction journeys affect interaction delays in the Performance panel.
115
115
  */
116
116
  recJourneyINP:
117
117
  'How a user interacts with the page influences interaction delays. Ensure you are testing common interactions.',
118
118
  /**
119
- * @description Text block explaining how dynamic content can affect LCP. "LCP" is a performance metric measuring when the largest content was rendered on the page. "LCP element" refers to the page element that was the largest content on the page.
119
+ * @description Recommendation explaining how dynamic content affects LCP in the Performance panel.
120
120
  */
121
121
  recDynamicContentLCP: 'The LCP element can vary between page loads if content is dynamic.',
122
122
  /**
123
- * @description Text block explaining how dynamic content can affect layout shifts. "layout shifts" refer to page instability where content moving around can create a jarring experience.
123
+ * @description Recommendation explaining how dynamic content affects layout shifts in the Performance panel.
124
124
  */
125
125
  recDynamicContentCLS: 'Dynamic content can influence what layout shifts happen.',
126
126
  /**
127
- * @description Column header for table cell values representing the subpart/component/stage/section of a larger duration.
127
+ * @description Table column header for subpart stage names in the live metrics view of the Performance panel.
128
128
  */
129
129
  subpart: 'Subpart',
130
130
  /**
131
- * @description Tooltip text for a link that goes to documentation explaining the Largest Contentful Paint (LCP) metric. "LCP" is an acronym and should not be translated.
131
+ * @description Tooltip text explaining the Largest Contentful Paint (LCP) metric in the live metrics view of the Performance panel.
132
132
  */
133
133
  lcpHelpTooltip:
134
134
  'LCP reports the render time of the largest image, text block, or video visible in the viewport. Click here to learn more about LCP.',
135
135
  /**
136
- * @description Tooltip text for a link that goes to documentation explaining the Cumulative Layout Shift (CLS) metric. "CLS" is an acronym and should not be translated.
136
+ * @description Tooltip text explaining the Cumulative Layout Shift (CLS) metric in the live metrics view of the Performance panel.
137
137
  */
138
138
  clsHelpTooltip: 'CLS measures the amount of unexpected shifted content. Click here to learn more about CLS.',
139
139
  /**
140
- * @description Tooltip text for a link that goes to documentation explaining the Interaction to Next Paint (INP) metric. "INP" is an acronym and should not be translated.
140
+ * @description Tooltip text explaining the Interaction to Next Paint (INP) metric in the live metrics view of the Performance panel.
141
141
  */
142
142
  inpHelpTooltip:
143
143
  'INP measures the overall responsiveness to all click, tap, and keyboard interactions. Click here to learn more about INP.',
@@ -26,91 +26,91 @@ const MAX_URL_LENGTH = 100;
26
26
 
27
27
  const UIStrings = {
28
28
  /**
29
- * @description Text that refers to the network request method
29
+ * @description Label for the HTTP request method in the network request details view of the Performance panel.
30
30
  */
31
31
  requestMethod: 'Request method',
32
32
  /**
33
- * @description Text that refers to the network request protocol
33
+ * @description Label for the network protocol in the network request details view of the Performance panel.
34
34
  */
35
35
  protocol: 'Protocol',
36
36
  /**
37
- * @description Text to show the priority of an item
37
+ * @description Label for the network request priority in the network request details view of the Performance panel.
38
38
  */
39
39
  priority: 'Priority',
40
40
  /**
41
- * @description Text used when referring to the data sent in a network request that is encoded as a particular file format.
41
+ * @description Label for the encoded data size in the network request details view of the Performance panel.
42
42
  */
43
43
  encodedData: 'Encoded data',
44
44
  /**
45
- * @description Text used to refer to the data sent in a network request that has been decoded.
45
+ * @description Label for the decoded body size in the network request details view of the Performance panel.
46
46
  */
47
47
  decodedBody: 'Decoded body',
48
48
  /**
49
- * @description Text in Timeline indicating that input has happened recently
49
+ * @description Value indicating yes in the network request details view of the Performance panel.
50
50
  */
51
51
  yes: 'Yes',
52
52
  /**
53
- * @description Text in Timeline indicating that input has not happened recently
53
+ * @description Value indicating no in the network request details view of the Performance panel.
54
54
  */
55
55
  no: 'No',
56
56
  /**
57
- * @description Text to indicate to the user they are viewing an event representing a network request.
57
+ * @description Header title for a network request in the network request details view of the Performance panel.
58
58
  */
59
59
  networkRequest: 'Network request',
60
60
  /**
61
- * @description Text for the data source of a network request.
61
+ * @description Label indicating whether a network request was served from cache in the network request details view of the Performance panel.
62
62
  */
63
63
  fromCache: 'From cache',
64
64
  /**
65
- * @description Text used to show the mime-type of the data transferred with a network request (e.g. "application/json").
65
+ * @description Label for the MIME type of a network request in the network request details view of the Performance panel.
66
66
  */
67
67
  mimeType: 'MIME type',
68
68
  /**
69
- * @description Text used to show the user that a request was served from the browser's in-memory cache.
69
+ * @description Suffix indicating that a network request was served from memory cache in the Performance panel.
70
70
  */
71
71
  FromMemoryCache: ' (from memory cache)',
72
72
  /**
73
- * @description Text used to show the user that a request was served from the browser's file cache.
73
+ * @description Suffix indicating that a network request was served from disk cache in the Performance panel.
74
74
  */
75
75
  FromCache: ' (from cache)',
76
76
  /**
77
- * @description Label for a network request indicating that it was a HTTP2 server push instead of a regular network request, in the Performance panel
77
+ * @description Suffix indicating that a network request was served from server push in the Performance panel.
78
78
  */
79
79
  FromPush: ' (from push)',
80
80
  /**
81
- * @description Text used to show a user that a request was served from an installed, active service worker.
81
+ * @description Suffix indicating that a network request was served from a service worker in the Performance panel.
82
82
  */
83
83
  FromServiceWorker: ' (from `service worker`)',
84
84
  /**
85
- * @description Text for the event initiated by another one
85
+ * @description Label indicating what initiated the network request in the network request details view of the Performance panel.
86
86
  */
87
87
  initiatedBy: 'Initiated by',
88
88
  /**
89
- * @description Text that refers to if the network request is blocking
89
+ * @description Label for the render-blocking status of a network request in the network request details view of the Performance panel.
90
90
  */
91
91
  blocking: 'Blocking',
92
92
  /**
93
- * @description Text that refers to if the network request is in-body parser render-blocking
93
+ * @description Status value indicating that a network request is in-body parser blocking in the Performance panel.
94
94
  */
95
95
  inBodyParserBlocking: 'In-body parser blocking',
96
96
  /**
97
- * @description Text that refers to if the network request is render-blocking
97
+ * @description Status value indicating that a network request is render-blocking in the Performance panel.
98
98
  */
99
99
  renderBlocking: 'Render-blocking',
100
100
  /**
101
- * @description Text to refer to a 3rd Party entity.
101
+ * @description Label for the third-party entity of a network request in the network request details view of the Performance panel.
102
102
  */
103
103
  entity: '3rd party',
104
104
  /**
105
- * @description Label for a column containing the names of timings (performance metric) taken in the server side application.
105
+ * @description Column header for server timing metric names in the network request details view of the Performance panel.
106
106
  */
107
107
  serverTiming: 'Server timing',
108
108
  /**
109
- * @description Label for a column containing the values of timings (performance metric) taken in the server side application.
109
+ * @description Column header for server timing duration values in the network request details view of the Performance panel.
110
110
  */
111
111
  time: 'Time',
112
112
  /**
113
- * @description Label for a column containing the description of timings (performance metric) taken in the server side application.
113
+ * @description Column header for server timing descriptions in the network request details view of the Performance panel.
114
114
  */
115
115
  description: 'Description',
116
116
  } as const;