@paulirish/trace_engine 0.0.67-beta.2 → 0.0.67

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 (759) hide show
  1. package/.tmp/tsbuildinfo/analyze-inspector-issues.d.mts +13 -0
  2. package/.tmp/tsbuildinfo/analyze-inspector-issues.d.mts.map +1 -0
  3. package/.tmp/tsbuildinfo/analyze-trace.d.mts +17 -0
  4. package/.tmp/tsbuildinfo/analyze-trace.d.mts.map +1 -0
  5. package/.tmp/tsbuildinfo/test/test-trace-engine.d.mts +2 -0
  6. package/.tmp/tsbuildinfo/test/test-trace-engine.d.mts.map +1 -0
  7. package/.tmp/tsbuildinfo/third_party/third-party-web/third-party-web.d.ts +3 -0
  8. package/.tmp/tsbuildinfo/third_party/third-party-web/third-party-web.d.ts.map +1 -0
  9. package/.tmp/tsbuildinfo/tsconfig.tsbuildinfo +1 -0
  10. package/README.md +22 -62
  11. package/analyze-inspector-issues.mjs +60 -0
  12. package/analyze-trace.mjs +144 -6
  13. package/core/common/ParsedURL.js +512 -0
  14. package/core/common/ParsedURL.js.map +1 -0
  15. package/core/common/common.d.ts +8 -33
  16. package/core/common/common.js +2 -0
  17. package/core/host/host.d.ts +1 -13
  18. package/core/host/host.js +1 -0
  19. package/core/i18n/i18n.d.ts +20 -8
  20. package/core/i18n/i18n.js +15 -0
  21. package/core/platform/ArrayUtilities.js +224 -0
  22. package/core/platform/ArrayUtilities.js.map +1 -0
  23. package/core/platform/Brand.js +5 -0
  24. package/core/platform/Brand.js.map +1 -0
  25. package/core/platform/Constructor.js +5 -0
  26. package/core/platform/Constructor.js.map +1 -0
  27. package/core/platform/DateUtilities.js +14 -0
  28. package/core/platform/DateUtilities.js.map +1 -0
  29. package/core/platform/DevToolsPath.js +28 -0
  30. package/core/platform/DevToolsPath.js.map +1 -0
  31. package/core/platform/HostRuntime.js +8 -0
  32. package/core/platform/HostRuntime.js.map +1 -0
  33. package/core/platform/KeyboardUtilities.js +34 -0
  34. package/core/platform/KeyboardUtilities.js.map +1 -0
  35. package/core/platform/MapUtilities.js +80 -0
  36. package/core/platform/MapUtilities.js.map +1 -0
  37. package/core/platform/MimeType.js +157 -0
  38. package/core/platform/MimeType.js.map +1 -0
  39. package/core/platform/NumberUtilities.js +73 -0
  40. package/core/platform/NumberUtilities.js.map +1 -0
  41. package/core/platform/Size.js +36 -0
  42. package/core/platform/Size.js.map +1 -0
  43. package/core/platform/StringUtilities.js +731 -0
  44. package/core/platform/StringUtilities.js.map +1 -0
  45. package/core/platform/Timing.js +10 -0
  46. package/core/platform/Timing.js.map +1 -0
  47. package/core/platform/TypedArrayUtilities.js +158 -0
  48. package/core/platform/TypedArrayUtilities.js.map +1 -0
  49. package/core/platform/TypescriptUtilities.js +17 -0
  50. package/core/platform/TypescriptUtilities.js.map +1 -0
  51. package/core/platform/UIString.d.ts +5 -2
  52. package/core/platform/UIString.js +5 -0
  53. package/core/platform/UIString.js.map +1 -0
  54. package/core/platform/UserVisibleError.d.ts +1 -12
  55. package/core/platform/UserVisibleError.js +23 -0
  56. package/core/platform/UserVisibleError.js.map +1 -0
  57. package/core/platform/api/HostRuntime.d.ts +1 -0
  58. package/core/platform/api/HostRuntime.js +5 -0
  59. package/core/platform/api/HostRuntime.js.map +1 -0
  60. package/core/platform/api/api-tsconfig.json +58 -0
  61. package/core/platform/api/api-tsconfig.ref.json +26 -0
  62. package/core/platform/api/api.js +6 -0
  63. package/core/platform/api/api.js.map +1 -0
  64. package/core/platform/bundle-tsconfig.json +59 -0
  65. package/core/platform/bundle-tsconfig.ref.json +27 -0
  66. package/core/platform/foundation_unittests-tsconfig.json +73 -0
  67. package/core/platform/foundation_unittests-tsconfig.ref.json +40 -0
  68. package/core/platform/foundation_unittests_node_typecheck-tsconfig.json +69 -0
  69. package/core/platform/platform-tsconfig.json +81 -0
  70. package/core/platform/platform-tsconfig.ref.json +49 -0
  71. package/core/platform/platform.js +28 -0
  72. package/core/platform/platform.js.map +1 -0
  73. package/core/platform/platform_node_typecheck-tsconfig.json +78 -0
  74. package/core/platform/platform_node_typecheck.stamp +0 -0
  75. package/core/root/root.d.ts +1 -4
  76. package/core/root/root.js +1 -0
  77. package/core/sdk/sdk.d.ts +27 -97
  78. package/core/sdk/sdk.js +1 -0
  79. package/generated/protocol.js +3304 -0
  80. package/locales/af.json +86 -92
  81. package/locales/am.json +350 -356
  82. package/locales/ar.json +351 -357
  83. package/locales/as.json +349 -355
  84. package/locales/az.json +340 -346
  85. package/locales/be.json +350 -356
  86. package/locales/bg.json +350 -356
  87. package/locales/bn.json +350 -356
  88. package/locales/bs.json +243 -249
  89. package/locales/ca.json +279 -285
  90. package/locales/cs.json +335 -341
  91. package/locales/cy.json +114 -120
  92. package/locales/da.json +199 -205
  93. package/locales/de.json +219 -225
  94. package/locales/el.json +335 -341
  95. package/locales/en-GB.json +8 -14
  96. package/locales/en-US.json +249 -252
  97. package/locales/en-XL.json +1055 -0
  98. package/locales/es-419.json +275 -281
  99. package/locales/es.json +276 -282
  100. package/locales/et.json +231 -237
  101. package/locales/eu.json +119 -125
  102. package/locales/fa.json +350 -356
  103. package/locales/fi.json +280 -286
  104. package/locales/fil.json +1 -7
  105. package/locales/fr-CA.json +307 -313
  106. package/locales/fr.json +304 -310
  107. package/locales/gl.json +259 -265
  108. package/locales/gu.json +351 -357
  109. package/locales/he.json +351 -357
  110. package/locales/hi.json +335 -341
  111. package/locales/hr.json +234 -240
  112. package/locales/hu.json +341 -347
  113. package/locales/hy.json +350 -356
  114. package/locales/id.json +2 -8
  115. package/locales/is.json +302 -308
  116. package/locales/it.json +136 -142
  117. package/locales/ja.json +350 -356
  118. package/locales/ka.json +351 -357
  119. package/locales/kk.json +351 -357
  120. package/locales/km.json +350 -356
  121. package/locales/kn.json +351 -357
  122. package/locales/ko.json +350 -356
  123. package/locales/ky.json +349 -355
  124. package/locales/lo.json +351 -357
  125. package/locales/lt.json +319 -325
  126. package/locales/lv.json +316 -322
  127. package/locales/mk.json +351 -357
  128. package/locales/ml.json +350 -356
  129. package/locales/mn.json +350 -356
  130. package/locales/mr.json +350 -356
  131. package/locales/ms.json +2 -8
  132. package/locales/my.json +349 -355
  133. package/locales/ne.json +335 -341
  134. package/locales/nl.json +61 -67
  135. package/locales/no.json +169 -175
  136. package/locales/or.json +350 -356
  137. package/locales/pa.json +350 -356
  138. package/locales/pl.json +306 -312
  139. package/locales/pt-PT.json +271 -277
  140. package/locales/pt.json +265 -271
  141. package/locales/ro.json +305 -311
  142. package/locales/ru.json +350 -356
  143. package/locales/si.json +351 -357
  144. package/locales/sk.json +332 -338
  145. package/locales/sl.json +214 -220
  146. package/locales/sq.json +315 -321
  147. package/locales/sr-Latn.json +252 -258
  148. package/locales/sr.json +351 -357
  149. package/locales/sv.json +275 -281
  150. package/locales/sw.json +2 -8
  151. package/locales/ta.json +351 -357
  152. package/locales/te.json +349 -355
  153. package/locales/th.json +351 -357
  154. package/locales/tr.json +325 -331
  155. package/locales/uk.json +350 -356
  156. package/locales/ur.json +351 -357
  157. package/locales/uz.json +159 -165
  158. package/locales/vi.json +351 -357
  159. package/locales/zh-HK.json +351 -357
  160. package/locales/zh-TW.json +350 -356
  161. package/locales/zh.json +350 -356
  162. package/locales/zu.json +2 -8
  163. package/models/cpu_profile/CPUProfileDataModel.js +517 -0
  164. package/models/cpu_profile/CPUProfileDataModel.js.map +1 -0
  165. package/models/cpu_profile/ProfileTreeModel.js +90 -0
  166. package/models/cpu_profile/ProfileTreeModel.js.map +1 -0
  167. package/models/cpu_profile/bundle-tsconfig.json +59 -0
  168. package/models/cpu_profile/bundle-tsconfig.ref.json +27 -0
  169. package/models/cpu_profile/cpu_profile-tsconfig.json +63 -0
  170. package/models/cpu_profile/cpu_profile-tsconfig.ref.json +31 -0
  171. package/models/cpu_profile/cpu_profile.js +7 -0
  172. package/models/cpu_profile/cpu_profile.js.map +1 -0
  173. package/models/cpu_profile/cpu_profile_node_typecheck-tsconfig.json +60 -0
  174. package/models/cpu_profile/cpu_profile_node_typecheck.stamp +0 -0
  175. package/models/cpu_profile/foundation_unittests-tsconfig.json +63 -0
  176. package/models/cpu_profile/foundation_unittests-tsconfig.ref.json +30 -0
  177. package/models/cpu_profile/foundation_unittests_node_typecheck-tsconfig.json +59 -0
  178. package/models/crux-manager/crux-manager.d.ts +3 -1
  179. package/models/crux-manager/crux-manager.js +1 -0
  180. package/models/trace/EntityMapper.js +133 -0
  181. package/models/trace/EntityMapper.js.map +1 -0
  182. package/models/trace/EventsSerializer.d.ts +1 -0
  183. package/models/trace/EventsSerializer.js +118 -0
  184. package/models/trace/EventsSerializer.js.map +1 -0
  185. package/models/trace/LanternComputationData.js +368 -0
  186. package/models/trace/LanternComputationData.js.map +1 -0
  187. package/models/trace/ModelImpl.js +181 -0
  188. package/models/trace/ModelImpl.js.map +1 -0
  189. package/models/trace/Name.js +115 -0
  190. package/models/trace/Name.js.map +1 -0
  191. package/models/trace/Processor.js +616 -0
  192. package/models/trace/Processor.js.map +1 -0
  193. package/models/trace/Styles.d.ts +2 -2
  194. package/models/trace/Styles.js +836 -0
  195. package/models/trace/Styles.js.map +1 -0
  196. package/models/trace/bundle-tsconfig.json +77 -0
  197. package/models/trace/bundle-tsconfig.ref.json +45 -0
  198. package/models/trace/extras/FilmStrip.js +45 -0
  199. package/models/trace/extras/FilmStrip.js.map +1 -0
  200. package/models/trace/extras/Initiators.js +47 -0
  201. package/models/trace/extras/Initiators.js.map +1 -0
  202. package/models/trace/extras/MainThreadActivity.js +77 -0
  203. package/models/trace/extras/MainThreadActivity.js.map +1 -0
  204. package/models/trace/extras/ScriptDuplication.js +163 -0
  205. package/models/trace/extras/ScriptDuplication.js.map +1 -0
  206. package/models/trace/extras/StackTraceForEvent.js +192 -0
  207. package/models/trace/extras/StackTraceForEvent.js.map +1 -0
  208. package/models/trace/extras/ThirdParties.js +119 -0
  209. package/models/trace/extras/ThirdParties.js.map +1 -0
  210. package/models/trace/extras/TraceFilter.js +51 -0
  211. package/models/trace/extras/TraceFilter.js.map +1 -0
  212. package/models/trace/extras/TraceTree.js +652 -0
  213. package/models/trace/extras/TraceTree.js.map +1 -0
  214. package/models/trace/extras/bundle-tsconfig.json +59 -0
  215. package/models/trace/extras/bundle-tsconfig.ref.json +27 -0
  216. package/models/trace/extras/extras-tsconfig.json +81 -0
  217. package/models/trace/extras/extras-tsconfig.ref.json +49 -0
  218. package/models/trace/extras/extras.js +12 -0
  219. package/models/trace/extras/extras.js.map +1 -0
  220. package/models/trace/extras/extras_node_typecheck-tsconfig.json +78 -0
  221. package/models/trace/extras/extras_node_typecheck.stamp +0 -0
  222. package/models/trace/extras/foundation_unittests-tsconfig.json +91 -0
  223. package/models/trace/extras/foundation_unittests-tsconfig.ref.json +58 -0
  224. package/models/trace/extras/foundation_unittests_node_typecheck-tsconfig.json +87 -0
  225. package/models/trace/foundation_unittests-tsconfig.json +70 -0
  226. package/models/trace/foundation_unittests-tsconfig.ref.json +37 -0
  227. package/models/trace/foundation_unittests_node_typecheck-tsconfig.json +66 -0
  228. package/models/trace/handlers/AnimationFramesHandler.js +110 -0
  229. package/models/trace/handlers/AnimationFramesHandler.js.map +1 -0
  230. package/models/trace/handlers/AnimationHandler.js +27 -0
  231. package/models/trace/handlers/AnimationHandler.js.map +1 -0
  232. package/models/trace/handlers/AsyncJSCallsHandler.js +188 -0
  233. package/models/trace/handlers/AsyncJSCallsHandler.js.map +1 -0
  234. package/models/trace/handlers/DOMStatsHandler.js +22 -0
  235. package/models/trace/handlers/DOMStatsHandler.js.map +1 -0
  236. package/models/trace/handlers/ExtensionTraceDataHandler.js +264 -0
  237. package/models/trace/handlers/ExtensionTraceDataHandler.js.map +1 -0
  238. package/models/trace/handlers/FlowsHandler.js +149 -0
  239. package/models/trace/handlers/FlowsHandler.js.map +1 -0
  240. package/models/trace/handlers/FramesHandler.js +491 -0
  241. package/models/trace/handlers/FramesHandler.js.map +1 -0
  242. package/models/trace/handlers/GPUHandler.js +36 -0
  243. package/models/trace/handlers/GPUHandler.js.map +1 -0
  244. package/models/trace/handlers/ImagePaintingHandler.js +148 -0
  245. package/models/trace/handlers/ImagePaintingHandler.js.map +1 -0
  246. package/models/trace/handlers/InitiatorsHandler.js +181 -0
  247. package/models/trace/handlers/InitiatorsHandler.js.map +1 -0
  248. package/models/trace/handlers/InvalidationsHandler.js +125 -0
  249. package/models/trace/handlers/InvalidationsHandler.js.map +1 -0
  250. package/models/trace/handlers/LargestImagePaintHandler.js +86 -0
  251. package/models/trace/handlers/LargestImagePaintHandler.js.map +1 -0
  252. package/models/trace/handlers/LargestTextPaintHandler.js +28 -0
  253. package/models/trace/handlers/LargestTextPaintHandler.js.map +1 -0
  254. package/models/trace/handlers/LayerTreeHandler.js +104 -0
  255. package/models/trace/handlers/LayerTreeHandler.js.map +1 -0
  256. package/models/trace/handlers/LayoutShiftsHandler.js +453 -0
  257. package/models/trace/handlers/LayoutShiftsHandler.js.map +1 -0
  258. package/models/trace/handlers/MemoryHandler.js +22 -0
  259. package/models/trace/handlers/MemoryHandler.js.map +1 -0
  260. package/models/trace/handlers/MetaHandler.js +442 -0
  261. package/models/trace/handlers/MetaHandler.js.map +1 -0
  262. package/models/trace/handlers/ModelHandlers.js +33 -0
  263. package/models/trace/handlers/ModelHandlers.js.map +1 -0
  264. package/models/trace/handlers/NetworkRequestsHandler.js +578 -0
  265. package/models/trace/handlers/NetworkRequestsHandler.js.map +1 -0
  266. package/models/trace/handlers/PageFramesHandler.js +43 -0
  267. package/models/trace/handlers/PageFramesHandler.js.map +1 -0
  268. package/models/trace/handlers/PageLoadMetricsHandler.js +463 -0
  269. package/models/trace/handlers/PageLoadMetricsHandler.js.map +1 -0
  270. package/models/trace/handlers/RendererHandler.js +346 -0
  271. package/models/trace/handlers/RendererHandler.js.map +1 -0
  272. package/models/trace/handlers/SamplesHandler.js +261 -0
  273. package/models/trace/handlers/SamplesHandler.js.map +1 -0
  274. package/models/trace/handlers/ScreenshotsHandler.js +56 -0
  275. package/models/trace/handlers/ScreenshotsHandler.js.map +1 -0
  276. package/models/trace/handlers/ScriptsHandler.js +277 -0
  277. package/models/trace/handlers/ScriptsHandler.js.map +1 -0
  278. package/models/trace/handlers/SelectorStatsHandler.js +72 -0
  279. package/models/trace/handlers/SelectorStatsHandler.js.map +1 -0
  280. package/models/trace/handlers/Threads.js +108 -0
  281. package/models/trace/handlers/Threads.js.map +1 -0
  282. package/models/trace/handlers/UserInteractionsHandler.js +319 -0
  283. package/models/trace/handlers/UserInteractionsHandler.js.map +1 -0
  284. package/models/trace/handlers/UserTimingsHandler.js +194 -0
  285. package/models/trace/handlers/UserTimingsHandler.js.map +1 -0
  286. package/models/trace/handlers/WarningsHandler.js +135 -0
  287. package/models/trace/handlers/WarningsHandler.js.map +1 -0
  288. package/models/trace/handlers/WorkersHandler.js +34 -0
  289. package/models/trace/handlers/WorkersHandler.js.map +1 -0
  290. package/models/trace/handlers/bundle-tsconfig.json +59 -0
  291. package/models/trace/handlers/bundle-tsconfig.ref.json +27 -0
  292. package/models/trace/handlers/foundation_unittests-tsconfig.json +102 -0
  293. package/models/trace/handlers/foundation_unittests-tsconfig.ref.json +69 -0
  294. package/models/trace/handlers/foundation_unittests_node_typecheck-tsconfig.json +98 -0
  295. package/models/trace/handlers/handlers-tsconfig.json +112 -0
  296. package/models/trace/handlers/handlers-tsconfig.ref.json +80 -0
  297. package/models/trace/handlers/handlers.js +8 -0
  298. package/models/trace/handlers/handlers.js.map +1 -0
  299. package/models/trace/handlers/handlers_node_typecheck-tsconfig.json +109 -0
  300. package/models/trace/handlers/handlers_node_typecheck.stamp +0 -0
  301. package/models/trace/handlers/helpers.js +167 -0
  302. package/models/trace/handlers/helpers.js.map +1 -0
  303. package/models/trace/handlers/types.js +2 -0
  304. package/models/trace/handlers/types.js.map +1 -0
  305. package/models/trace/helpers/Extensions.js +42 -0
  306. package/models/trace/helpers/Extensions.js.map +1 -0
  307. package/models/trace/helpers/Network.js +103 -0
  308. package/models/trace/helpers/Network.js.map +1 -0
  309. package/models/trace/helpers/SamplesIntegrator.js +527 -0
  310. package/models/trace/helpers/SamplesIntegrator.js.map +1 -0
  311. package/models/trace/helpers/SyntheticEvents.js +96 -0
  312. package/models/trace/helpers/SyntheticEvents.js.map +1 -0
  313. package/models/trace/helpers/Timing.js +200 -0
  314. package/models/trace/helpers/Timing.js.map +1 -0
  315. package/models/trace/helpers/Trace.js +844 -0
  316. package/models/trace/helpers/Trace.js.map +1 -0
  317. package/models/trace/helpers/TreeHelpers.js +255 -0
  318. package/models/trace/helpers/TreeHelpers.js.map +1 -0
  319. package/models/trace/helpers/bundle-tsconfig.json +59 -0
  320. package/models/trace/helpers/bundle-tsconfig.ref.json +27 -0
  321. package/models/trace/helpers/foundation_unittests-tsconfig.json +73 -0
  322. package/models/trace/helpers/foundation_unittests-tsconfig.ref.json +40 -0
  323. package/models/trace/helpers/foundation_unittests_node_typecheck-tsconfig.json +69 -0
  324. package/models/trace/helpers/helpers-tsconfig.json +77 -0
  325. package/models/trace/helpers/helpers-tsconfig.ref.json +45 -0
  326. package/models/trace/helpers/helpers.js +11 -0
  327. package/models/trace/helpers/helpers.js.map +1 -0
  328. package/models/trace/helpers/helpers_node_typecheck-tsconfig.json +74 -0
  329. package/models/trace/helpers/helpers_node_typecheck.stamp +0 -0
  330. package/models/trace/insights/CLSCulprits.d.ts +14 -14
  331. package/models/trace/insights/CLSCulprits.js +519 -0
  332. package/models/trace/insights/CLSCulprits.js.map +1 -0
  333. package/models/trace/insights/Cache.d.ts +6 -6
  334. package/models/trace/insights/Cache.js +210 -0
  335. package/models/trace/insights/Cache.js.map +1 -0
  336. package/models/trace/insights/CharacterSet.d.ts +8 -8
  337. package/models/trace/insights/CharacterSet.js +132 -0
  338. package/models/trace/insights/CharacterSet.js.map +1 -0
  339. package/models/trace/insights/Common.js +367 -0
  340. package/models/trace/insights/Common.js.map +1 -0
  341. package/models/trace/insights/DOMSize.d.ts +13 -13
  342. package/models/trace/insights/DOMSize.js +182 -0
  343. package/models/trace/insights/DOMSize.js.map +1 -0
  344. package/models/trace/insights/DocumentLatency.d.ts +11 -11
  345. package/models/trace/insights/DocumentLatency.js +259 -0
  346. package/models/trace/insights/DocumentLatency.js.map +1 -0
  347. package/models/trace/insights/DuplicatedJavaScript.d.ts +5 -5
  348. package/models/trace/insights/DuplicatedJavaScript.js +110 -0
  349. package/models/trace/insights/DuplicatedJavaScript.js.map +1 -0
  350. package/models/trace/insights/FontDisplay.d.ts +5 -5
  351. package/models/trace/insights/FontDisplay.js +93 -0
  352. package/models/trace/insights/FontDisplay.js.map +1 -0
  353. package/models/trace/insights/ForcedReflow.d.ts +7 -7
  354. package/models/trace/insights/ForcedReflow.js +162 -0
  355. package/models/trace/insights/ForcedReflow.js.map +1 -0
  356. package/models/trace/insights/INPBreakdown.d.ts +8 -8
  357. package/models/trace/insights/INPBreakdown.js +130 -0
  358. package/models/trace/insights/INPBreakdown.js.map +1 -0
  359. package/models/trace/insights/ImageDelivery.d.ts +12 -12
  360. package/models/trace/insights/ImageDelivery.js +264 -0
  361. package/models/trace/insights/ImageDelivery.js.map +1 -0
  362. package/models/trace/insights/LCPBreakdown.d.ts +11 -11
  363. package/models/trace/insights/LCPBreakdown.js +200 -0
  364. package/models/trace/insights/LCPBreakdown.js.map +1 -0
  365. package/models/trace/insights/LCPDiscovery.d.ts +10 -10
  366. package/models/trace/insights/LCPDiscovery.js +190 -0
  367. package/models/trace/insights/LCPDiscovery.js.map +1 -0
  368. package/models/trace/insights/LegacyJavaScript.d.ts +5 -5
  369. package/models/trace/insights/LegacyJavaScript.js +99 -0
  370. package/models/trace/insights/LegacyJavaScript.js.map +1 -0
  371. package/models/trace/insights/Models.js +23 -0
  372. package/models/trace/insights/Models.js.map +1 -0
  373. package/models/trace/insights/ModernHTTP.d.ts +5 -5
  374. package/models/trace/insights/ModernHTTP.js +205 -0
  375. package/models/trace/insights/ModernHTTP.js.map +1 -0
  376. package/models/trace/insights/NetworkDependencyTree.d.ts +19 -19
  377. package/models/trace/insights/NetworkDependencyTree.js +551 -0
  378. package/models/trace/insights/NetworkDependencyTree.js.map +1 -0
  379. package/models/trace/insights/RenderBlocking.d.ts +5 -5
  380. package/models/trace/insights/RenderBlocking.js +211 -0
  381. package/models/trace/insights/RenderBlocking.js.map +1 -0
  382. package/models/trace/insights/SlowCSSSelector.d.ts +10 -10
  383. package/models/trace/insights/SlowCSSSelector.js +140 -0
  384. package/models/trace/insights/SlowCSSSelector.js.map +1 -0
  385. package/models/trace/insights/Statistics.js +93 -0
  386. package/models/trace/insights/Statistics.js.map +1 -0
  387. package/models/trace/insights/ThirdParties.d.ts +6 -6
  388. package/models/trace/insights/ThirdParties.js +110 -0
  389. package/models/trace/insights/ThirdParties.js.map +1 -0
  390. package/models/trace/insights/Viewport.d.ts +3 -3
  391. package/models/trace/insights/Viewport.js +105 -0
  392. package/models/trace/insights/Viewport.js.map +1 -0
  393. package/models/trace/insights/bundle-tsconfig.json +59 -0
  394. package/models/trace/insights/bundle-tsconfig.ref.json +27 -0
  395. package/models/trace/insights/foundation_unittests-tsconfig.json +98 -0
  396. package/models/trace/insights/foundation_unittests-tsconfig.ref.json +65 -0
  397. package/models/trace/insights/foundation_unittests_node_typecheck-tsconfig.json +94 -0
  398. package/models/trace/insights/insights-tsconfig.json +114 -0
  399. package/models/trace/insights/insights-tsconfig.ref.json +82 -0
  400. package/models/trace/insights/insights.js +10 -0
  401. package/models/trace/insights/insights.js.map +1 -0
  402. package/models/trace/insights/insights_node_typecheck-tsconfig.json +111 -0
  403. package/models/trace/insights/insights_node_typecheck.stamp +0 -0
  404. package/models/trace/insights/types.d.ts +3 -3
  405. package/models/trace/insights/types.js +41 -0
  406. package/models/trace/insights/types.js.map +1 -0
  407. package/models/trace/lantern/bundle-tsconfig.json +71 -0
  408. package/models/trace/lantern/bundle-tsconfig.ref.json +39 -0
  409. package/models/trace/lantern/core/LanternError.js +7 -0
  410. package/models/trace/lantern/core/LanternError.js.map +1 -0
  411. package/models/trace/lantern/core/NetworkAnalyzer.js +496 -0
  412. package/models/trace/lantern/core/NetworkAnalyzer.js.map +1 -0
  413. package/models/trace/lantern/core/bundle-tsconfig.json +59 -0
  414. package/models/trace/lantern/core/bundle-tsconfig.ref.json +27 -0
  415. package/models/trace/lantern/core/core-tsconfig.json +60 -0
  416. package/models/trace/lantern/core/core-tsconfig.ref.json +28 -0
  417. package/models/trace/lantern/core/core.js +6 -0
  418. package/models/trace/lantern/core/core.js.map +1 -0
  419. package/models/trace/lantern/core/core_node_typecheck-tsconfig.json +57 -0
  420. package/models/trace/lantern/core/core_node_typecheck.stamp +0 -0
  421. package/models/trace/lantern/core/foundation_unittests-tsconfig.json +69 -0
  422. package/models/trace/lantern/core/foundation_unittests-tsconfig.ref.json +36 -0
  423. package/models/trace/lantern/core/foundation_unittests_node_typecheck-tsconfig.json +65 -0
  424. package/models/trace/lantern/graph/BaseNode.d.ts +2 -2
  425. package/models/trace/lantern/graph/BaseNode.js +277 -0
  426. package/models/trace/lantern/graph/BaseNode.js.map +1 -0
  427. package/models/trace/lantern/graph/CPUNode.js +80 -0
  428. package/models/trace/lantern/graph/CPUNode.js.map +1 -0
  429. package/models/trace/lantern/graph/NetworkNode.js +95 -0
  430. package/models/trace/lantern/graph/NetworkNode.js.map +1 -0
  431. package/models/trace/lantern/graph/PageDependencyGraph.js +574 -0
  432. package/models/trace/lantern/graph/PageDependencyGraph.js.map +1 -0
  433. package/models/trace/lantern/graph/bundle-tsconfig.json +59 -0
  434. package/models/trace/lantern/graph/bundle-tsconfig.ref.json +27 -0
  435. package/models/trace/lantern/graph/foundation_unittests-tsconfig.json +61 -0
  436. package/models/trace/lantern/graph/foundation_unittests-tsconfig.ref.json +28 -0
  437. package/models/trace/lantern/graph/foundation_unittests_node_typecheck-tsconfig.json +57 -0
  438. package/models/trace/lantern/graph/graph-tsconfig.json +65 -0
  439. package/models/trace/lantern/graph/graph-tsconfig.ref.json +33 -0
  440. package/models/trace/lantern/graph/graph.js +8 -0
  441. package/models/trace/lantern/graph/graph.js.map +1 -0
  442. package/models/trace/lantern/graph/graph_node_typecheck-tsconfig.json +62 -0
  443. package/models/trace/lantern/graph/graph_node_typecheck.stamp +0 -0
  444. package/models/trace/lantern/lantern.js +10 -0
  445. package/models/trace/lantern/lantern.js.map +1 -0
  446. package/models/trace/lantern/metrics/FirstContentfulPaint.js +137 -0
  447. package/models/trace/lantern/metrics/FirstContentfulPaint.js.map +1 -0
  448. package/models/trace/lantern/metrics/Interactive.js +68 -0
  449. package/models/trace/lantern/metrics/Interactive.js.map +1 -0
  450. package/models/trace/lantern/metrics/LargestContentfulPaint.js +75 -0
  451. package/models/trace/lantern/metrics/LargestContentfulPaint.js.map +1 -0
  452. package/models/trace/lantern/metrics/MaxPotentialFID.js +49 -0
  453. package/models/trace/lantern/metrics/MaxPotentialFID.js.map +1 -0
  454. package/models/trace/lantern/metrics/Metric.js +69 -0
  455. package/models/trace/lantern/metrics/Metric.js.map +1 -0
  456. package/models/trace/lantern/metrics/SpeedIndex.js +102 -0
  457. package/models/trace/lantern/metrics/SpeedIndex.js.map +1 -0
  458. package/models/trace/lantern/metrics/TBTUtils.js +65 -0
  459. package/models/trace/lantern/metrics/TBTUtils.js.map +1 -0
  460. package/models/trace/lantern/metrics/TotalBlockingTime.js +79 -0
  461. package/models/trace/lantern/metrics/TotalBlockingTime.js.map +1 -0
  462. package/models/trace/lantern/metrics/bundle-tsconfig.json +59 -0
  463. package/models/trace/lantern/metrics/bundle-tsconfig.ref.json +27 -0
  464. package/models/trace/lantern/metrics/foundation_unittests-tsconfig.json +76 -0
  465. package/models/trace/lantern/metrics/foundation_unittests-tsconfig.ref.json +43 -0
  466. package/models/trace/lantern/metrics/foundation_unittests_node_typecheck-tsconfig.json +72 -0
  467. package/models/trace/lantern/metrics/metrics-tsconfig.json +75 -0
  468. package/models/trace/lantern/metrics/metrics-tsconfig.ref.json +43 -0
  469. package/models/trace/lantern/metrics/metrics.js +12 -0
  470. package/models/trace/lantern/metrics/metrics.js.map +1 -0
  471. package/models/trace/lantern/metrics/metrics_node_typecheck-tsconfig.json +72 -0
  472. package/models/trace/lantern/metrics/metrics_node_typecheck.stamp +0 -0
  473. package/models/trace/lantern/simulation/ConnectionPool.js +116 -0
  474. package/models/trace/lantern/simulation/ConnectionPool.js.map +1 -0
  475. package/models/trace/lantern/simulation/Constants.js +45 -0
  476. package/models/trace/lantern/simulation/Constants.js.map +1 -0
  477. package/models/trace/lantern/simulation/DNSCache.js +48 -0
  478. package/models/trace/lantern/simulation/DNSCache.js.map +1 -0
  479. package/models/trace/lantern/simulation/SimulationTimingMap.js +135 -0
  480. package/models/trace/lantern/simulation/SimulationTimingMap.js.map +1 -0
  481. package/models/trace/lantern/simulation/Simulator.js +457 -0
  482. package/models/trace/lantern/simulation/Simulator.js.map +1 -0
  483. package/models/trace/lantern/simulation/TCPConnection.js +155 -0
  484. package/models/trace/lantern/simulation/TCPConnection.js.map +1 -0
  485. package/models/trace/lantern/simulation/bundle-tsconfig.json +59 -0
  486. package/models/trace/lantern/simulation/bundle-tsconfig.ref.json +27 -0
  487. package/models/trace/lantern/simulation/foundation_unittests-tsconfig.json +75 -0
  488. package/models/trace/lantern/simulation/foundation_unittests-tsconfig.ref.json +42 -0
  489. package/models/trace/lantern/simulation/foundation_unittests_node_typecheck-tsconfig.json +71 -0
  490. package/models/trace/lantern/simulation/simulation-tsconfig.json +70 -0
  491. package/models/trace/lantern/simulation/simulation-tsconfig.ref.json +38 -0
  492. package/models/trace/lantern/simulation/simulation.js +10 -0
  493. package/models/trace/lantern/simulation/simulation.js.map +1 -0
  494. package/models/trace/lantern/simulation/simulation_node_typecheck-tsconfig.json +67 -0
  495. package/models/trace/lantern/simulation/simulation_node_typecheck.stamp +0 -0
  496. package/models/trace/lantern/testing/bundle-tsconfig.json +60 -0
  497. package/models/trace/lantern/testing/bundle-tsconfig.ref.json +27 -0
  498. package/models/trace/lantern/testing/testing-tsconfig.json +63 -0
  499. package/models/trace/lantern/testing/testing-tsconfig.ref.json +30 -0
  500. package/models/trace/lantern/types/Lantern.d.ts +19 -19
  501. package/models/trace/lantern/types/Lantern.js +25 -0
  502. package/models/trace/lantern/types/Lantern.js.map +1 -0
  503. package/models/trace/lantern/types/bundle-tsconfig.json +59 -0
  504. package/models/trace/lantern/types/bundle-tsconfig.ref.json +27 -0
  505. package/models/trace/lantern/types/types-tsconfig.json +59 -0
  506. package/models/trace/lantern/types/types-tsconfig.ref.json +27 -0
  507. package/models/trace/lantern/types/types.js +5 -0
  508. package/models/trace/lantern/types/types.js.map +1 -0
  509. package/models/trace/lantern/types/types_node_typecheck-tsconfig.json +56 -0
  510. package/models/trace/lantern/types/types_node_typecheck.stamp +0 -0
  511. package/models/trace/trace-tsconfig.json +89 -0
  512. package/models/trace/trace-tsconfig.ref.json +57 -0
  513. package/models/trace/trace.js +16 -544
  514. package/models/trace/trace.js.map +1 -0
  515. package/models/trace/trace_node_typecheck-tsconfig.json +86 -0
  516. package/models/trace/trace_node_typecheck.stamp +0 -0
  517. package/models/trace/types/Configuration.d.ts +2 -2
  518. package/models/trace/types/Configuration.js +19 -0
  519. package/models/trace/types/Configuration.js.map +1 -0
  520. package/models/trace/types/Extensions.d.ts +1 -1
  521. package/models/trace/types/Extensions.js +38 -0
  522. package/models/trace/types/Extensions.js.map +1 -0
  523. package/models/trace/types/File.d.ts +9 -3
  524. package/models/trace/types/File.js +92 -0
  525. package/models/trace/types/File.js.map +1 -0
  526. package/models/trace/types/Overlays.js +5 -0
  527. package/models/trace/types/Overlays.js.map +1 -0
  528. package/models/trace/types/Timing.js +16 -0
  529. package/models/trace/types/Timing.js.map +1 -0
  530. package/models/trace/types/TraceEvents.d.ts +21 -16
  531. package/models/trace/types/TraceEvents.js +983 -0
  532. package/models/trace/types/TraceEvents.js.map +1 -0
  533. package/models/trace/types/bundle-tsconfig.json +59 -0
  534. package/models/trace/types/bundle-tsconfig.ref.json +27 -0
  535. package/models/trace/types/foundation_unittests-tsconfig.json +67 -0
  536. package/models/trace/types/foundation_unittests-tsconfig.ref.json +34 -0
  537. package/models/trace/types/foundation_unittests_node_typecheck-tsconfig.json +63 -0
  538. package/models/trace/types/types-tsconfig.json +76 -0
  539. package/models/trace/types/types-tsconfig.ref.json +44 -0
  540. package/models/trace/types/types.js +10 -0
  541. package/models/trace/types/types.js.map +1 -0
  542. package/models/trace/types/types_node_typecheck-tsconfig.json +73 -0
  543. package/models/trace/types/types_node_typecheck.stamp +0 -0
  544. package/package.json +8 -40
  545. package/test/invalid-animation-events.json.gz +0 -0
  546. package/test/test-trace-engine.mjs +191 -0
  547. package/third_party/legacy-javascript/bundle-tsconfig.json +59 -0
  548. package/third_party/legacy-javascript/bundle-tsconfig.ref.json +27 -0
  549. package/third_party/legacy-javascript/legacy-javascript-tsconfig.ref.json +15 -0
  550. package/third_party/legacy-javascript/legacy-javascript.js +3 -0
  551. package/third_party/legacy-javascript/legacy-javascript.js.map +1 -0
  552. package/third_party/legacy-javascript/lib/legacy-javascript.js +1119 -0
  553. package/third_party/marked/marked.d.ts +1 -2
  554. package/third_party/marked/marked.js +1 -0
  555. package/third_party/third-party-web/third-party-web.d.ts +1 -2
  556. package/third_party/third-party-web/third-party-web.js +1 -0
  557. package/tsconfig.json +29 -0
  558. package/core/common/Base64.d.ts +0 -12
  559. package/core/common/CharacterIdMap.d.ts +0 -5
  560. package/core/common/Color.d.ts +0 -357
  561. package/core/common/ColorConverter.d.ts +0 -26
  562. package/core/common/ColorUtils.d.ts +0 -45
  563. package/core/common/Console.d.ts +0 -54
  564. package/core/common/Debouncer.d.ts +0 -8
  565. package/core/common/EventTarget.d.ts +0 -22
  566. package/core/common/Gzip.d.ts +0 -23
  567. package/core/common/JavaScriptMetaData.d.ts +0 -20
  568. package/core/common/Lazy.d.ts +0 -4
  569. package/core/common/MapWithDefault.d.ts +0 -9
  570. package/core/common/Mutex.d.ts +0 -13
  571. package/core/common/Object.d.ts +0 -20
  572. package/core/common/Progress.d.ts +0 -47
  573. package/core/common/ResolverBase.d.ts +0 -29
  574. package/core/common/ResourceType.d.ts +0 -52
  575. package/core/common/ReturnToPanel.d.ts +0 -10
  576. package/core/common/Revealer.d.ts +0 -66
  577. package/core/common/Runnable.d.ts +0 -14
  578. package/core/common/SegmentedRange.d.ts +0 -14
  579. package/core/common/SettingRegistration.d.ts +0 -136
  580. package/core/common/Settings.d.ts +0 -228
  581. package/core/common/SimpleHistoryManager.d.ts +0 -20
  582. package/core/common/Srcset.d.ts +0 -16
  583. package/core/common/StringOutputStream.d.ts +0 -10
  584. package/core/common/TextDictionary.d.ts +0 -11
  585. package/core/common/Throttler.d.ts +0 -12
  586. package/core/common/Trie.d.ts +0 -24
  587. package/core/common/VersionController.d.ts +0 -85
  588. package/core/host/AidaClient.d.ts +0 -73
  589. package/core/host/AidaClientTypes.d.ts +0 -355
  590. package/core/host/AidaGcaTranslation.d.ts +0 -10
  591. package/core/host/DispatchHttpRequestClient.d.ts +0 -14
  592. package/core/host/GcaClient.d.ts +0 -14
  593. package/core/host/GcaTypes.d.ts +0 -411
  594. package/core/host/GdpClient.d.ts +0 -84
  595. package/core/host/InspectorFrontendHost.d.ts +0 -29
  596. package/core/host/InspectorFrontendHostAPI.d.ts +0 -425
  597. package/core/host/InspectorFrontendHostStub.d.ts +0 -151
  598. package/core/host/Platform.d.ts +0 -16
  599. package/core/host/ResourceLoader.d.ts +0 -15
  600. package/core/host/UserMetrics.d.ts +0 -116
  601. package/core/host/UserMetricsEnums.d.ts +0 -888
  602. package/core/i18n/ByteUtilities.d.ts +0 -11
  603. package/core/i18n/DevToolsLocale.d.ts +0 -41
  604. package/core/i18n/NumberFormatter.d.ts +0 -11
  605. package/core/i18n/i18nImpl.d.ts +0 -64
  606. package/core/i18n/i18nTypes.d.ts +0 -5
  607. package/core/i18n/locales.d.ts +0 -15
  608. package/core/i18n/time-utilities.d.ts +0 -16
  609. package/core/platform/browser/HostRuntime.d.ts +0 -2
  610. package/core/platform/browser/browser.d.ts +0 -2
  611. package/core/platform/node/HostRuntime.d.ts +0 -2
  612. package/core/platform/node/node.d.ts +0 -2
  613. package/core/protocol_client/CDPConnection.d.ts +0 -77
  614. package/core/protocol_client/ConnectionTransport.d.ts +0 -9
  615. package/core/protocol_client/DevToolsCDPConnection.d.ts +0 -16
  616. package/core/protocol_client/InspectorBackend.d.ts +0 -223
  617. package/core/protocol_client/protocol_client.d.ts +0 -5
  618. package/core/root/DevToolsContext.d.ts +0 -34
  619. package/core/root/ExperimentNames.d.ts +0 -9
  620. package/core/root/Runtime.d.ts +0 -353
  621. package/core/sdk/AccessibilityModel.d.ts +0 -76
  622. package/core/sdk/AnimationModel.d.ts +0 -161
  623. package/core/sdk/AutofillModel.d.ts +0 -23
  624. package/core/sdk/CPUProfilerModel.d.ts +0 -46
  625. package/core/sdk/CPUThrottlingManager.d.ts +0 -47
  626. package/core/sdk/CSSContainerQuery.d.ts +0 -42
  627. package/core/sdk/CSSFontFace.d.ts +0 -10
  628. package/core/sdk/CSSLayer.d.ts +0 -9
  629. package/core/sdk/CSSLocation.d.ts +0 -14
  630. package/core/sdk/CSSMatchedStyles.d.ts +0 -138
  631. package/core/sdk/CSSMedia.d.ts +0 -36
  632. package/core/sdk/CSSMetadata.d.ts +0 -87
  633. package/core/sdk/CSSModel.d.ts +0 -185
  634. package/core/sdk/CSSNavigation.d.ts +0 -10
  635. package/core/sdk/CSSProperty.d.ts +0 -53
  636. package/core/sdk/CSSPropertyParser.d.ts +0 -126
  637. package/core/sdk/CSSPropertyParserMatchers.d.ts +0 -442
  638. package/core/sdk/CSSQuery.d.ts +0 -22
  639. package/core/sdk/CSSRule.d.ts +0 -132
  640. package/core/sdk/CSSScope.d.ts +0 -9
  641. package/core/sdk/CSSStartingStyle.d.ts +0 -9
  642. package/core/sdk/CSSStyleDeclaration.d.ts +0 -38
  643. package/core/sdk/CSSStyleSheetHeader.d.ts +0 -53
  644. package/core/sdk/CSSSupports.d.ts +0 -10
  645. package/core/sdk/CategorizedBreakpoint.d.ts +0 -42
  646. package/core/sdk/ChildTargetManager.d.ts +0 -40
  647. package/core/sdk/CompilerSourceMappingContentProvider.d.ts +0 -12
  648. package/core/sdk/Connections.d.ts +0 -36
  649. package/core/sdk/ConsoleModel.d.ts +0 -127
  650. package/core/sdk/ConsoleModelTypes.d.ts +0 -6
  651. package/core/sdk/Cookie.d.ts +0 -68
  652. package/core/sdk/CookieModel.d.ts +0 -31
  653. package/core/sdk/CookieParser.d.ts +0 -14
  654. package/core/sdk/CrashReportContextModel.d.ts +0 -8
  655. package/core/sdk/DOMDebuggerModel.d.ts +0 -127
  656. package/core/sdk/DOMModel.d.ts +0 -440
  657. package/core/sdk/DOMStorageModel.d.ts +0 -79
  658. package/core/sdk/DebuggerModel.d.ts +0 -305
  659. package/core/sdk/EmulationModel.d.ts +0 -95
  660. package/core/sdk/EnhancedTracesParser.d.ts +0 -105
  661. package/core/sdk/EventBreakpointsModel.d.ts +0 -66
  662. package/core/sdk/FrameAssociated.d.ts +0 -6
  663. package/core/sdk/FrameManager.d.ts +0 -68
  664. package/core/sdk/HeapProfilerModel.d.ts +0 -75
  665. package/core/sdk/HttpReasonPhraseStrings.d.ts +0 -5
  666. package/core/sdk/IOModel.d.ts +0 -10
  667. package/core/sdk/IsolateManager.d.ts +0 -53
  668. package/core/sdk/IssuesModel.d.ts +0 -28
  669. package/core/sdk/LayerTreeBase.d.ts +0 -70
  670. package/core/sdk/LogModel.d.ts +0 -20
  671. package/core/sdk/NetworkManager.d.ts +0 -418
  672. package/core/sdk/NetworkRequest.d.ts +0 -497
  673. package/core/sdk/NetworkRequestAccess.d.ts +0 -91
  674. package/core/sdk/OverlayColorGenerator.d.ts +0 -14
  675. package/core/sdk/OverlayModel.d.ts +0 -186
  676. package/core/sdk/OverlayPersistentHighlighter.d.ts +0 -116
  677. package/core/sdk/PageFunctions.d.ts +0 -22
  678. package/core/sdk/PageLoad.d.ts +0 -14
  679. package/core/sdk/PageResourceLoader.d.ts +0 -111
  680. package/core/sdk/PaintProfiler.d.ts +0 -43
  681. package/core/sdk/PerformanceMetricsModel.d.ts +0 -12
  682. package/core/sdk/PreloadingModel.d.ts +0 -146
  683. package/core/sdk/RehydratingConnection.d.ts +0 -73
  684. package/core/sdk/RehydratingObject.d.ts +0 -59
  685. package/core/sdk/RemoteObject.d.ts +0 -210
  686. package/core/sdk/Resource.d.ts +0 -36
  687. package/core/sdk/ResourceTreeModel.d.ts +0 -280
  688. package/core/sdk/RuntimeModel.d.ts +0 -164
  689. package/core/sdk/SDKModel.d.ts +0 -30
  690. package/core/sdk/SDKSettings.d.ts +0 -54
  691. package/core/sdk/ScopeTreeCache.d.ts +0 -21
  692. package/core/sdk/ScreenCaptureModel.d.ts +0 -69
  693. package/core/sdk/Script.d.ts +0 -134
  694. package/core/sdk/SecurityOrigin.d.ts +0 -108
  695. package/core/sdk/SecurityOriginManager.d.ts +0 -23
  696. package/core/sdk/ServerSentEvents.d.ts +0 -18
  697. package/core/sdk/ServerSentEventsProtocol.d.ts +0 -18
  698. package/core/sdk/ServerTiming.d.ts +0 -24
  699. package/core/sdk/ServiceWorkerCacheModel.d.ts +0 -71
  700. package/core/sdk/ServiceWorkerManager.d.ts +0 -125
  701. package/core/sdk/SourceMap.d.ts +0 -211
  702. package/core/sdk/SourceMapCache.d.ts +0 -12
  703. package/core/sdk/SourceMapFunctionRanges.d.ts +0 -23
  704. package/core/sdk/SourceMapManager.d.ts +0 -46
  705. package/core/sdk/SourceMapRangeMappings.d.ts +0 -15
  706. package/core/sdk/SourceMapScopeChainEntry.d.ts +0 -23
  707. package/core/sdk/SourceMapScopesInfo.d.ts +0 -184
  708. package/core/sdk/StorageBucketsModel.d.ts +0 -48
  709. package/core/sdk/StorageKeyManager.d.ts +0 -38
  710. package/core/sdk/Target.d.ts +0 -79
  711. package/core/sdk/TargetManager.d.ts +0 -92
  712. package/core/sdk/TraceObject.d.ts +0 -43
  713. package/core/sdk/WebAuthnModel.d.ts +0 -29
  714. package/core/text_utils/CodeMirrorUtils.d.ts +0 -3
  715. package/core/text_utils/ContentData.d.ts +0 -94
  716. package/core/text_utils/ContentProvider.d.ts +0 -42
  717. package/core/text_utils/Markdown.d.ts +0 -13
  718. package/core/text_utils/StaticContentProvider.d.ts +0 -13
  719. package/core/text_utils/StreamingContentData.d.ts +0 -49
  720. package/core/text_utils/Text.d.ts +0 -19
  721. package/core/text_utils/TextCursor.d.ts +0 -9
  722. package/core/text_utils/TextRange.d.ts +0 -81
  723. package/core/text_utils/TextUtils.d.ts +0 -97
  724. package/core/text_utils/WasmDisassembly.d.ts +0 -29
  725. package/core/text_utils/text_utils.d.ts +0 -12
  726. package/entrypoints/formatter_actions/formatter_actions.d.ts +0 -65
  727. package/generated/InspectorBackendCommands.d.ts +0 -14
  728. package/generated/SupportedCSSProperties.d.ts +0 -18
  729. package/generated/protocol-mapping.d.ts +0 -5985
  730. package/generated/protocol-proxy-api.d.ts +0 -5447
  731. package/index.d.ts +0 -2
  732. package/index.js +0 -6
  733. package/models/crux-manager/CrUXManager.d.ts +0 -107
  734. package/models/emulation/DeviceModeModel.d.ts +0 -157
  735. package/models/emulation/EmulatedDevices.d.ts +0 -148
  736. package/models/emulation/emulation.d.ts +0 -3
  737. package/models/formatter/FormatterWorkerPool.d.ts +0 -58
  738. package/models/formatter/ScriptFormatter.d.ts +0 -11
  739. package/models/formatter/formatter.d.ts +0 -3
  740. package/third_party/codemirror.next/codemirror.next.d.ts +0 -9196
  741. package/third_party/i18n/i18n-impl.d.ts +0 -25
  742. package/third_party/i18n/i18n.d.ts +0 -3
  743. package/third_party/i18n/localized-string-set.d.ts +0 -49
  744. package/third_party/intl-messageformat/intl-messageformat.d.ts +0 -1
  745. package/third_party/marked/package/lib/marked.esm.d.ts +0 -760
  746. package/third_party/source-map-scopes-codec/package/src/builder/builder.d.ts +0 -70
  747. package/third_party/source-map-scopes-codec/package/src/builder/safe_builder.d.ts +0 -40
  748. package/third_party/source-map-scopes-codec/package/src/codec.d.ts +0 -49
  749. package/third_party/source-map-scopes-codec/package/src/decode/decode.d.ts +0 -33
  750. package/third_party/source-map-scopes-codec/package/src/encode/encode.d.ts +0 -8
  751. package/third_party/source-map-scopes-codec/package/src/encode/encoder.d.ts +0 -9
  752. package/third_party/source-map-scopes-codec/package/src/mod.d.ts +0 -5
  753. package/third_party/source-map-scopes-codec/package/src/scopes.d.ts +0 -169
  754. package/third_party/source-map-scopes-codec/package/src/util.d.ts +0 -5
  755. package/third_party/source-map-scopes-codec/package/src/vlq.d.ts +0 -14
  756. package/third_party/source-map-scopes-codec/source-map-scopes-codec.d.ts +0 -1
  757. package/third_party/third-party-web/lib/nostats-subset.d.ts +0 -2
  758. package/third_party/third-party-web/package/lib/index.d.ts +0 -34
  759. package/third_party/third-party-web/package/lib/subsets/nostats.d.ts +0 -1
@@ -0,0 +1,519 @@
1
+ // Copyright 2024 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
+ import * as i18n from '../../../core/i18n/i18n.js';
5
+ import * as Platform from '../../../core/platform/platform.js';
6
+ import * as Handlers from '../handlers/handlers.js';
7
+ import * as Helpers from '../helpers/helpers.js';
8
+ import * as Types from '../types/types.js';
9
+ import { InsightCategory, InsightKeys, } from './types.js';
10
+ export const UIStrings = {
11
+ /**
12
+ * @description Title of an insight that provides details about why elements shift/move on the page. The causes for these shifts are referred to as culprits ("reasons").
13
+ */
14
+ title: 'Layout shift culprits',
15
+ /**
16
+ * @description Description of a DevTools insight that identifies the reasons that elements shift on the page.
17
+ * This is displayed after a user expands the section to see more. No character length limits.
18
+ */
19
+ description: 'Layout shifts occur when elements move absent any user interaction. [Investigate the causes of layout shifts](https://developer.chrome.com/docs/performance/insights/cls-culprit), such as elements being added, removed, or their fonts changing as the page loads.',
20
+ /**
21
+ * @description Text indicating the worst layout shift cluster.
22
+ */
23
+ worstLayoutShiftCluster: 'Worst layout shift cluster',
24
+ /**
25
+ * @description Text indicating the worst layout shift cluster.
26
+ */
27
+ worstCluster: 'Worst cluster',
28
+ /**
29
+ * @description Text indicating a layout shift cluster and its start time.
30
+ * @example {32 ms} PH1
31
+ */
32
+ layoutShiftCluster: 'Layout shift cluster @ {PH1}',
33
+ /**
34
+ * @description Text indicating the biggest reasons for the layout shifts.
35
+ */
36
+ topCulprits: 'Top layout shift culprits',
37
+ /**
38
+ * @description Text for a culprit type of Injected iframe.
39
+ */
40
+ injectedIframe: 'Injected iframe',
41
+ /**
42
+ * @description Text for a culprit type of web font request.
43
+ */
44
+ webFont: 'Web font',
45
+ /**
46
+ * @description Text for a culprit type of Animation.
47
+ */
48
+ animation: 'Animation',
49
+ /**
50
+ * @description Text for a culprit type of Unsized image.
51
+ */
52
+ unsizedImage: 'Unsized image element',
53
+ /**
54
+ * @description Text status when there were no layout shifts detected.
55
+ */
56
+ noLayoutShifts: 'No layout shifts',
57
+ /**
58
+ * @description Text status when no layout shift culprits or root causes were found.
59
+ */
60
+ noCulprits: 'Couldn’t detect any layout shift culprits',
61
+ };
62
+ const str_ = i18n.i18n.registerUIStrings('models/trace/insights/CLSCulprits.ts', UIStrings);
63
+ export const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
64
+ export var AnimationFailureReasons;
65
+ (function (AnimationFailureReasons) {
66
+ AnimationFailureReasons["ACCELERATED_ANIMATIONS_DISABLED"] = "ACCELERATED_ANIMATIONS_DISABLED";
67
+ AnimationFailureReasons["EFFECT_SUPPRESSED_BY_DEVTOOLS"] = "EFFECT_SUPPRESSED_BY_DEVTOOLS";
68
+ AnimationFailureReasons["INVALID_ANIMATION_OR_EFFECT"] = "INVALID_ANIMATION_OR_EFFECT";
69
+ AnimationFailureReasons["EFFECT_HAS_UNSUPPORTED_TIMING_PARAMS"] = "EFFECT_HAS_UNSUPPORTED_TIMING_PARAMS";
70
+ AnimationFailureReasons["EFFECT_HAS_NON_REPLACE_COMPOSITE_MODE"] = "EFFECT_HAS_NON_REPLACE_COMPOSITE_MODE";
71
+ AnimationFailureReasons["TARGET_HAS_INVALID_COMPOSITING_STATE"] = "TARGET_HAS_INVALID_COMPOSITING_STATE";
72
+ AnimationFailureReasons["TARGET_HAS_INCOMPATIBLE_ANIMATIONS"] = "TARGET_HAS_INCOMPATIBLE_ANIMATIONS";
73
+ AnimationFailureReasons["TARGET_HAS_CSS_OFFSET"] = "TARGET_HAS_CSS_OFFSET";
74
+ AnimationFailureReasons["ANIMATION_AFFECTS_NON_CSS_PROPERTIES"] = "ANIMATION_AFFECTS_NON_CSS_PROPERTIES";
75
+ AnimationFailureReasons["TRANSFORM_RELATED_PROPERTY_CANNOT_BE_ACCELERATED_ON_TARGET"] = "TRANSFORM_RELATED_PROPERTY_CANNOT_BE_ACCELERATED_ON_TARGET";
76
+ AnimationFailureReasons["TRANSFROM_BOX_SIZE_DEPENDENT"] = "TRANSFROM_BOX_SIZE_DEPENDENT";
77
+ AnimationFailureReasons["FILTER_RELATED_PROPERTY_MAY_MOVE_PIXELS"] = "FILTER_RELATED_PROPERTY_MAY_MOVE_PIXELS";
78
+ AnimationFailureReasons["UNSUPPORTED_CSS_PROPERTY"] = "UNSUPPORTED_CSS_PROPERTY";
79
+ AnimationFailureReasons["MIXED_KEYFRAME_VALUE_TYPES"] = "MIXED_KEYFRAME_VALUE_TYPES";
80
+ AnimationFailureReasons["TIMELINE_SOURCE_HAS_INVALID_COMPOSITING_STATE"] = "TIMELINE_SOURCE_HAS_INVALID_COMPOSITING_STATE";
81
+ AnimationFailureReasons["ANIMATION_HAS_NO_VISIBLE_CHANGE"] = "ANIMATION_HAS_NO_VISIBLE_CHANGE";
82
+ AnimationFailureReasons["AFFECTS_IMPORTANT_PROPERTY"] = "AFFECTS_IMPORTANT_PROPERTY";
83
+ AnimationFailureReasons["SVG_TARGET_HAS_INDEPENDENT_TRANSFORM_PROPERTY"] = "SVG_TARGET_HAS_INDEPENDENT_TRANSFORM_PROPERTY";
84
+ })(AnimationFailureReasons || (AnimationFailureReasons = {}));
85
+ export var LayoutShiftType;
86
+ (function (LayoutShiftType) {
87
+ LayoutShiftType[LayoutShiftType["WEB_FONT"] = 0] = "WEB_FONT";
88
+ LayoutShiftType[LayoutShiftType["IFRAMES"] = 1] = "IFRAMES";
89
+ LayoutShiftType[LayoutShiftType["ANIMATIONS"] = 2] = "ANIMATIONS";
90
+ LayoutShiftType[LayoutShiftType["UNSIZED_IMAGE"] = 3] = "UNSIZED_IMAGE";
91
+ })(LayoutShiftType || (LayoutShiftType = {}));
92
+ /**
93
+ * Each failure reason is represented by a bit flag. The bit shift operator '<<' is used to define
94
+ * which bit corresponds to each failure reason.
95
+ * https://source.chromium.org/search?q=f:compositor_animations.h%20%22enum%20FailureReason%22
96
+ */
97
+ const ACTIONABLE_FAILURE_REASONS = [
98
+ {
99
+ flag: 1 << 0,
100
+ failure: AnimationFailureReasons.ACCELERATED_ANIMATIONS_DISABLED,
101
+ },
102
+ {
103
+ flag: 1 << 1,
104
+ failure: AnimationFailureReasons.EFFECT_SUPPRESSED_BY_DEVTOOLS,
105
+ },
106
+ {
107
+ flag: 1 << 2,
108
+ failure: AnimationFailureReasons.INVALID_ANIMATION_OR_EFFECT,
109
+ },
110
+ {
111
+ flag: 1 << 3,
112
+ failure: AnimationFailureReasons.EFFECT_HAS_UNSUPPORTED_TIMING_PARAMS,
113
+ },
114
+ {
115
+ flag: 1 << 4,
116
+ failure: AnimationFailureReasons.EFFECT_HAS_NON_REPLACE_COMPOSITE_MODE,
117
+ },
118
+ {
119
+ flag: 1 << 5,
120
+ failure: AnimationFailureReasons.TARGET_HAS_INVALID_COMPOSITING_STATE,
121
+ },
122
+ {
123
+ flag: 1 << 6,
124
+ failure: AnimationFailureReasons.TARGET_HAS_INCOMPATIBLE_ANIMATIONS,
125
+ },
126
+ {
127
+ flag: 1 << 7,
128
+ failure: AnimationFailureReasons.TARGET_HAS_CSS_OFFSET,
129
+ },
130
+ // The failure 1 << 8 is marked as obsolete in Blink
131
+ {
132
+ flag: 1 << 9,
133
+ failure: AnimationFailureReasons.ANIMATION_AFFECTS_NON_CSS_PROPERTIES,
134
+ },
135
+ {
136
+ flag: 1 << 10,
137
+ failure: AnimationFailureReasons.TRANSFORM_RELATED_PROPERTY_CANNOT_BE_ACCELERATED_ON_TARGET,
138
+ },
139
+ {
140
+ flag: 1 << 11,
141
+ failure: AnimationFailureReasons.TRANSFROM_BOX_SIZE_DEPENDENT,
142
+ },
143
+ {
144
+ flag: 1 << 12,
145
+ failure: AnimationFailureReasons.FILTER_RELATED_PROPERTY_MAY_MOVE_PIXELS,
146
+ },
147
+ {
148
+ flag: 1 << 13,
149
+ failure: AnimationFailureReasons.UNSUPPORTED_CSS_PROPERTY,
150
+ },
151
+ // The failure 1 << 14 is marked as obsolete in Blink
152
+ {
153
+ flag: 1 << 15,
154
+ failure: AnimationFailureReasons.MIXED_KEYFRAME_VALUE_TYPES,
155
+ },
156
+ {
157
+ flag: 1 << 16,
158
+ failure: AnimationFailureReasons.TIMELINE_SOURCE_HAS_INVALID_COMPOSITING_STATE,
159
+ },
160
+ {
161
+ flag: 1 << 17,
162
+ failure: AnimationFailureReasons.ANIMATION_HAS_NO_VISIBLE_CHANGE,
163
+ },
164
+ {
165
+ flag: 1 << 18,
166
+ failure: AnimationFailureReasons.AFFECTS_IMPORTANT_PROPERTY,
167
+ },
168
+ {
169
+ flag: 1 << 19,
170
+ failure: AnimationFailureReasons.SVG_TARGET_HAS_INDEPENDENT_TRANSFORM_PROPERTY,
171
+ },
172
+ ];
173
+ // 500ms window.
174
+ // Use this window to consider events and requests that may have caused a layout shift.
175
+ const ROOT_CAUSE_WINDOW = Helpers.Timing.secondsToMicro(Types.Timing.Seconds(0.5));
176
+ /**
177
+ * Returns if an event happens within the root cause window, before the target event.
178
+ * ROOT_CAUSE_WINDOW v target event
179
+ * |------------------------|=======================
180
+ */
181
+ function isInRootCauseWindow(event, targetEvent) {
182
+ const eventEnd = event.dur ? event.ts + event.dur : event.ts;
183
+ return eventEnd < targetEvent.ts && eventEnd >= targetEvent.ts - ROOT_CAUSE_WINDOW;
184
+ }
185
+ export function getNonCompositedFailure(animationEvent) {
186
+ const failures = [];
187
+ const beginEvent = animationEvent.args.data.beginEvent;
188
+ const instantEvents = animationEvent.args.data.instantEvents || [];
189
+ /**
190
+ * Animation events containing composite information are ASYNC_NESTABLE_INSTANT ('n').
191
+ * An animation may also contain multiple 'n' events, so we look through those with useful non-composited data.
192
+ */
193
+ for (const event of instantEvents) {
194
+ const failureMask = event.args.data.compositeFailed;
195
+ const unsupportedProperties = event.args.data.unsupportedProperties;
196
+ if (!failureMask) {
197
+ continue;
198
+ }
199
+ const failureReasons = ACTIONABLE_FAILURE_REASONS.filter(reason => failureMask & reason.flag).map(reason => reason.failure);
200
+ const failure = {
201
+ name: beginEvent.args.data.displayName,
202
+ failureReasons,
203
+ unsupportedProperties,
204
+ animation: animationEvent,
205
+ };
206
+ failures.push(failure);
207
+ }
208
+ return failures;
209
+ }
210
+ function getNonCompositedFailureRootCauses(animationEvents, prePaintEvents, shiftsByPrePaint, rootCausesByShift) {
211
+ const allAnimationFailures = [];
212
+ for (const animation of animationEvents) {
213
+ /**
214
+ * Animation events containing composite information are ASYNC_NESTABLE_INSTANT ('n').
215
+ * An animation may also contain multiple 'n' events, so we look through those with useful non-composited data.
216
+ */
217
+ const failures = getNonCompositedFailure(animation);
218
+ if (!failures) {
219
+ continue;
220
+ }
221
+ allAnimationFailures.push(...failures);
222
+ const nextPrePaint = getNextEvent(prePaintEvents, animation);
223
+ // If no following prePaint, this is not a root cause.
224
+ if (!nextPrePaint) {
225
+ continue;
226
+ }
227
+ // If the animation event is outside the ROOT_CAUSE_WINDOW, it could not be a root cause.
228
+ if (!isInRootCauseWindow(animation, nextPrePaint)) {
229
+ continue;
230
+ }
231
+ const shifts = shiftsByPrePaint.get(nextPrePaint);
232
+ // if no layout shift(s), this is not a root cause.
233
+ if (!shifts) {
234
+ continue;
235
+ }
236
+ for (const shift of shifts) {
237
+ const rootCausesForShift = rootCausesByShift.get(shift);
238
+ if (!rootCausesForShift) {
239
+ throw new Error('Unaccounted shift');
240
+ }
241
+ rootCausesForShift.nonCompositedAnimations.push(...failures);
242
+ }
243
+ }
244
+ return allAnimationFailures;
245
+ }
246
+ /**
247
+ * Given an array of layout shift and PrePaint events, returns a mapping from
248
+ * PrePaint events to layout shifts dispatched within it.
249
+ */
250
+ function getShiftsByPrePaintEvents(layoutShifts, prePaintEvents) {
251
+ // Maps from PrePaint events to LayoutShifts that occurred in each one.
252
+ const shiftsByPrePaint = new Map();
253
+ // Associate all shifts to their corresponding PrePaint.
254
+ for (const prePaintEvent of prePaintEvents) {
255
+ const firstShiftIndex = Platform.ArrayUtilities.nearestIndexFromBeginning(layoutShifts, shift => shift.ts >= prePaintEvent.ts);
256
+ if (firstShiftIndex === null) {
257
+ // No layout shifts registered after this PrePaint start. Continue.
258
+ continue;
259
+ }
260
+ for (let i = firstShiftIndex; i < layoutShifts.length; i++) {
261
+ const shift = layoutShifts[i];
262
+ if (shift.ts >= prePaintEvent.ts && shift.ts <= prePaintEvent.ts + prePaintEvent.dur) {
263
+ const shiftsInPrePaint = Platform.MapUtilities.getWithDefault(shiftsByPrePaint, prePaintEvent, () => []);
264
+ shiftsInPrePaint.push(shift);
265
+ }
266
+ if (shift.ts > prePaintEvent.ts + prePaintEvent.dur) {
267
+ // Reached all layoutShifts of this PrePaint. Break out to continue with the next prePaint event.
268
+ break;
269
+ }
270
+ }
271
+ }
272
+ return shiftsByPrePaint;
273
+ }
274
+ /**
275
+ * Given a source event list, this returns the first event of that list that directly follows the target event.
276
+ */
277
+ function getNextEvent(sourceEvents, targetEvent) {
278
+ const index = Platform.ArrayUtilities.nearestIndexFromBeginning(sourceEvents, source => source.ts > targetEvent.ts + (targetEvent.dur || 0));
279
+ // No PrePaint event registered after this event
280
+ if (index === null) {
281
+ return undefined;
282
+ }
283
+ return sourceEvents[index];
284
+ }
285
+ /**
286
+ * An Iframe is considered a root cause if the iframe event occurs before a prePaint event
287
+ * and within this prePaint event a layout shift(s) occurs.
288
+ */
289
+ function getIframeRootCauses(data, iframeCreatedEvents, prePaintEvents, shiftsByPrePaint, rootCausesByShift, domLoadingEvents) {
290
+ for (const iframeEvent of iframeCreatedEvents) {
291
+ const nextPrePaint = getNextEvent(prePaintEvents, iframeEvent);
292
+ // If no following prePaint, this is not a root cause.
293
+ if (!nextPrePaint) {
294
+ continue;
295
+ }
296
+ const shifts = shiftsByPrePaint.get(nextPrePaint);
297
+ // if no layout shift(s), this is not a root cause.
298
+ if (!shifts) {
299
+ continue;
300
+ }
301
+ for (const shift of shifts) {
302
+ const rootCausesForShift = rootCausesByShift.get(shift);
303
+ if (!rootCausesForShift) {
304
+ throw new Error('Unaccounted shift');
305
+ }
306
+ // Look for the first dom event that occurs within the bounds of the iframe event.
307
+ // This contains the frame id.
308
+ const domEvent = domLoadingEvents.find(e => {
309
+ const maxIframe = Types.Timing.Micro(iframeEvent.ts + (iframeEvent.dur ?? 0));
310
+ return e.ts >= iframeEvent.ts && e.ts <= maxIframe;
311
+ });
312
+ if (domEvent?.args.frame) {
313
+ const frame = domEvent.args.frame;
314
+ let url;
315
+ const processes = data.Meta.rendererProcessesByFrame.get(frame);
316
+ if (processes && processes.size > 0) {
317
+ url = [...processes.values()][0]?.[0].frame.url;
318
+ }
319
+ rootCausesForShift.iframes.push({ frame, url });
320
+ }
321
+ }
322
+ }
323
+ return rootCausesByShift;
324
+ }
325
+ /**
326
+ * An unsized image is considered a root cause if its PaintImage can be correlated to a
327
+ * layout shift. We can correlate PaintImages with unsized images by their matching nodeIds.
328
+ * X <- layout shift
329
+ * |----------------|
330
+ * ^ PrePaint event |-----|
331
+ * ^ PaintImage
332
+ */
333
+ function getUnsizedImageRootCauses(unsizedImageEvents, paintImageEvents, shiftsByPrePaint, rootCausesByShift) {
334
+ shiftsByPrePaint.forEach((shifts, prePaint) => {
335
+ const paintImage = getNextEvent(paintImageEvents, prePaint);
336
+ if (!paintImage) {
337
+ return;
338
+ }
339
+ // The unsized image corresponds to this PaintImage.
340
+ const matchingNode = unsizedImageEvents.find(unsizedImage => unsizedImage.args.data.nodeId === paintImage.args.data.nodeId);
341
+ if (!matchingNode) {
342
+ return;
343
+ }
344
+ // The unsized image is a potential root cause of all the shifts of this prePaint.
345
+ for (const shift of shifts) {
346
+ const rootCausesForShift = rootCausesByShift.get(shift);
347
+ if (!rootCausesForShift) {
348
+ throw new Error('Unaccounted shift');
349
+ }
350
+ rootCausesForShift.unsizedImages.push({
351
+ backendNodeId: matchingNode.args.data.nodeId,
352
+ paintImageEvent: paintImage,
353
+ });
354
+ }
355
+ });
356
+ return rootCausesByShift;
357
+ }
358
+ export function isCLSCulpritsInsight(insight) {
359
+ return insight.insightKey === InsightKeys.CLS_CULPRITS;
360
+ }
361
+ /**
362
+ * A font request is considered a root cause if the request occurs before a prePaint event
363
+ * and within this prePaint event a layout shift(s) occurs. Additionally, this font request should
364
+ * happen within the ROOT_CAUSE_WINDOW of the prePaint event.
365
+ */
366
+ function getFontRootCauses(networkRequests, prePaintEvents, shiftsByPrePaint, rootCausesByShift) {
367
+ const fontRequests = networkRequests.filter(req => req.args.data.resourceType === 'Font' && req.args.data.mimeType.startsWith('font'));
368
+ for (const req of fontRequests) {
369
+ const nextPrePaint = getNextEvent(prePaintEvents, req);
370
+ if (!nextPrePaint) {
371
+ continue;
372
+ }
373
+ // If the req is outside the ROOT_CAUSE_WINDOW, it could not be a root cause.
374
+ if (!isInRootCauseWindow(req, nextPrePaint)) {
375
+ continue;
376
+ }
377
+ // Get the shifts that belong to this prepaint
378
+ const shifts = shiftsByPrePaint.get(nextPrePaint);
379
+ // if no layout shift(s) in this prePaint, the request is not a root cause.
380
+ if (!shifts) {
381
+ continue;
382
+ }
383
+ // Include the root cause to the shifts in this prePaint.
384
+ for (const shift of shifts) {
385
+ const rootCausesForShift = rootCausesByShift.get(shift);
386
+ if (!rootCausesForShift) {
387
+ throw new Error('Unaccounted shift');
388
+ }
389
+ rootCausesForShift.webFonts.push(req);
390
+ }
391
+ }
392
+ return rootCausesByShift;
393
+ }
394
+ /**
395
+ * Returns the top 3 shift root causes based on the given cluster.
396
+ */
397
+ function getTopCulprits(cluster, culpritsByShift) {
398
+ const MAX_TOP_CULPRITS = 3;
399
+ const causes = [];
400
+ const shifts = cluster.events;
401
+ for (const shift of shifts) {
402
+ const culprits = culpritsByShift.get(shift);
403
+ if (!culprits) {
404
+ continue;
405
+ }
406
+ const fontReq = culprits.webFonts;
407
+ const iframes = culprits.iframes;
408
+ const animations = culprits.nonCompositedAnimations;
409
+ const unsizedImages = culprits.unsizedImages;
410
+ for (let i = 0; i < fontReq.length && causes.length < MAX_TOP_CULPRITS; i++) {
411
+ causes.push({ type: LayoutShiftType.WEB_FONT, description: i18nString(UIStrings.webFont) });
412
+ }
413
+ for (let i = 0; i < iframes.length && causes.length < MAX_TOP_CULPRITS; i++) {
414
+ causes.push({ type: LayoutShiftType.IFRAMES, description: i18nString(UIStrings.injectedIframe) });
415
+ }
416
+ for (let i = 0; i < animations.length && causes.length < MAX_TOP_CULPRITS; i++) {
417
+ causes.push({ type: LayoutShiftType.ANIMATIONS, description: i18nString(UIStrings.animation) });
418
+ }
419
+ for (let i = 0; i < unsizedImages.length && causes.length < MAX_TOP_CULPRITS; i++) {
420
+ causes.push({
421
+ type: LayoutShiftType.UNSIZED_IMAGE,
422
+ description: i18nString(UIStrings.unsizedImage),
423
+ url: unsizedImages[i].paintImageEvent.args.data.url || '',
424
+ backendNodeId: unsizedImages[i].backendNodeId,
425
+ frame: unsizedImages[i].paintImageEvent.args.data.frame || '',
426
+ });
427
+ }
428
+ if (causes.length >= MAX_TOP_CULPRITS) {
429
+ break;
430
+ }
431
+ }
432
+ return causes.slice(0, MAX_TOP_CULPRITS);
433
+ }
434
+ function finalize(partialModel) {
435
+ let state = 'pass';
436
+ if (partialModel.worstCluster) {
437
+ const classification = Handlers.ModelHandlers.LayoutShifts.scoreClassificationForLayoutShift(partialModel.worstCluster.clusterCumulativeScore);
438
+ if (classification === Handlers.ModelHandlers.PageLoadMetrics.ScoreClassification.GOOD) {
439
+ state = 'informative';
440
+ }
441
+ else {
442
+ state = 'fail';
443
+ }
444
+ }
445
+ return {
446
+ insightKey: InsightKeys.CLS_CULPRITS,
447
+ strings: UIStrings,
448
+ title: i18nString(UIStrings.title),
449
+ description: i18nString(UIStrings.description),
450
+ docs: 'https://developer.chrome.com/docs/performance/insights/cls-culprit',
451
+ category: InsightCategory.CLS,
452
+ state,
453
+ ...partialModel,
454
+ };
455
+ }
456
+ export function generateInsight(data, context) {
457
+ const isWithinContext = (event) => Helpers.Timing.eventIsInBounds(event, context.bounds);
458
+ const compositeAnimationEvents = data.Animations.animations.filter(isWithinContext);
459
+ const iframeEvents = data.LayoutShifts.renderFrameImplCreateChildFrameEvents.filter(isWithinContext);
460
+ const networkRequests = data.NetworkRequests.byTime.filter(isWithinContext);
461
+ const domLoadingEvents = data.LayoutShifts.domLoadingEvents.filter(isWithinContext);
462
+ const unsizedImageEvents = data.LayoutShifts.layoutImageUnsizedEvents.filter(isWithinContext);
463
+ const clusters = data.LayoutShifts.clusters.filter(isWithinContext);
464
+ const clustersByScore = clusters.toSorted((a, b) => b.clusterCumulativeScore - a.clusterCumulativeScore);
465
+ const worstCluster = clustersByScore.at(0);
466
+ const layoutShifts = clusters.flatMap(cluster => cluster.events);
467
+ const prePaintEvents = data.LayoutShifts.prePaintEvents.filter(isWithinContext);
468
+ const paintImageEvents = data.LayoutShifts.paintImageEvents.filter(isWithinContext);
469
+ // Get root causes.
470
+ const rootCausesByShift = new Map();
471
+ const shiftsByPrePaint = getShiftsByPrePaintEvents(layoutShifts, prePaintEvents);
472
+ for (const shift of layoutShifts) {
473
+ rootCausesByShift.set(shift, { iframes: [], webFonts: [], nonCompositedAnimations: [], unsizedImages: [] });
474
+ }
475
+ // Populate root causes for rootCausesByShift.
476
+ getIframeRootCauses(data, iframeEvents, prePaintEvents, shiftsByPrePaint, rootCausesByShift, domLoadingEvents);
477
+ getFontRootCauses(networkRequests, prePaintEvents, shiftsByPrePaint, rootCausesByShift);
478
+ getUnsizedImageRootCauses(unsizedImageEvents, paintImageEvents, shiftsByPrePaint, rootCausesByShift);
479
+ const animationFailures = getNonCompositedFailureRootCauses(compositeAnimationEvents, prePaintEvents, shiftsByPrePaint, rootCausesByShift);
480
+ const relatedEvents = [...layoutShifts];
481
+ if (worstCluster) {
482
+ relatedEvents.push(worstCluster);
483
+ }
484
+ const topCulpritsByCluster = new Map();
485
+ for (const cluster of clusters) {
486
+ topCulpritsByCluster.set(cluster, getTopCulprits(cluster, rootCausesByShift));
487
+ }
488
+ return finalize({
489
+ relatedEvents,
490
+ animationFailures,
491
+ shifts: rootCausesByShift,
492
+ clusters,
493
+ worstCluster,
494
+ topCulpritsByCluster,
495
+ });
496
+ }
497
+ export function createOverlays(model) {
498
+ const clustersByScore = model.clusters.toSorted((a, b) => b.clusterCumulativeScore - a.clusterCumulativeScore) ?? [];
499
+ const worstCluster = clustersByScore[0];
500
+ if (!worstCluster) {
501
+ return [];
502
+ }
503
+ const range = Types.Timing.Micro(worstCluster.dur ?? 0);
504
+ const max = Types.Timing.Micro(worstCluster.ts + range);
505
+ return [{
506
+ type: 'TIMESPAN_BREAKDOWN',
507
+ sections: [
508
+ {
509
+ bounds: { min: worstCluster.ts, range, max },
510
+ label: i18nString(UIStrings.worstLayoutShiftCluster),
511
+ showDuration: false,
512
+ },
513
+ ],
514
+ // This allows for the overlay to sit over the layout shift.
515
+ entry: worstCluster.events[0],
516
+ renderLocation: 'ABOVE_EVENT',
517
+ }];
518
+ }
519
+ //# sourceMappingURL=CLSCulprits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CLSCulprits.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/CLSCulprits.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 The Chromium Authors\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nimport * as i18n from '../../../core/i18n/i18n.js';\nimport * as Platform from '../../../core/platform/platform.js';\nimport type * as Protocol from '../../../generated/protocol.js';\nimport * as Handlers from '../handlers/handlers.js';\nimport * as Helpers from '../helpers/helpers.js';\nimport * as Types from '../types/types.js';\n\nimport {\n InsightCategory,\n InsightKeys,\n type InsightModel,\n type InsightSetContext,\n type PartialInsightModel,\n} from './types.js';\n\nexport const UIStrings = {\n /**\n * @description Title of an insight that provides details about why elements shift/move on the page. The causes for these shifts are referred to as culprits (\"reasons\").\n */\n title: 'Layout shift culprits',\n /**\n * @description Description of a DevTools insight that identifies the reasons that elements shift on the page.\n * This is displayed after a user expands the section to see more. No character length limits.\n */\n description:\n 'Layout shifts occur when elements move absent any user interaction. [Investigate the causes of layout shifts](https://developer.chrome.com/docs/performance/insights/cls-culprit), such as elements being added, removed, or their fonts changing as the page loads.',\n /**\n * @description Text indicating the worst layout shift cluster.\n */\n worstLayoutShiftCluster: 'Worst layout shift cluster',\n /**\n * @description Text indicating the worst layout shift cluster.\n */\n worstCluster: 'Worst cluster',\n /**\n * @description Text indicating a layout shift cluster and its start time.\n * @example {32 ms} PH1\n */\n layoutShiftCluster: 'Layout shift cluster @ {PH1}',\n /**\n * @description Text indicating the biggest reasons for the layout shifts.\n */\n topCulprits: 'Top layout shift culprits',\n /**\n * @description Text for a culprit type of Injected iframe.\n */\n injectedIframe: 'Injected iframe',\n /**\n * @description Text for a culprit type of web font request.\n */\n webFont: 'Web font',\n /**\n * @description Text for a culprit type of Animation.\n */\n animation: 'Animation',\n /**\n * @description Text for a culprit type of Unsized image.\n */\n unsizedImage: 'Unsized image element',\n /**\n * @description Text status when there were no layout shifts detected.\n */\n noLayoutShifts: 'No layout shifts',\n /**\n * @description Text status when no layout shift culprits or root causes were found.\n */\n noCulprits: 'Couldn’t detect any layout shift culprits',\n} as const;\n\nconst str_ = i18n.i18n.registerUIStrings('models/trace/insights/CLSCulprits.ts', UIStrings);\nexport const i18nString: i18n.LocalizeString = i18n.i18n.getLocalizedString.bind(undefined, str_);\n\nexport type CLSCulpritsInsightModel = InsightModel<typeof UIStrings, {\n animationFailures: readonly NoncompositedAnimationFailure[],\n shifts: Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>,\n clusters: Types.Events.SyntheticLayoutShiftCluster[],\n worstCluster: Types.Events.SyntheticLayoutShiftCluster | undefined,\n /** The top 3 shift root causes for each cluster. */\n topCulpritsByCluster: Map<Types.Events.SyntheticLayoutShiftCluster, LayoutShiftItem[]>,\n}>;\n\nexport enum AnimationFailureReasons {\n ACCELERATED_ANIMATIONS_DISABLED = 'ACCELERATED_ANIMATIONS_DISABLED',\n EFFECT_SUPPRESSED_BY_DEVTOOLS = 'EFFECT_SUPPRESSED_BY_DEVTOOLS',\n INVALID_ANIMATION_OR_EFFECT = 'INVALID_ANIMATION_OR_EFFECT',\n EFFECT_HAS_UNSUPPORTED_TIMING_PARAMS = 'EFFECT_HAS_UNSUPPORTED_TIMING_PARAMS',\n EFFECT_HAS_NON_REPLACE_COMPOSITE_MODE = 'EFFECT_HAS_NON_REPLACE_COMPOSITE_MODE',\n TARGET_HAS_INVALID_COMPOSITING_STATE = 'TARGET_HAS_INVALID_COMPOSITING_STATE',\n TARGET_HAS_INCOMPATIBLE_ANIMATIONS = 'TARGET_HAS_INCOMPATIBLE_ANIMATIONS',\n TARGET_HAS_CSS_OFFSET = 'TARGET_HAS_CSS_OFFSET',\n ANIMATION_AFFECTS_NON_CSS_PROPERTIES = 'ANIMATION_AFFECTS_NON_CSS_PROPERTIES',\n TRANSFORM_RELATED_PROPERTY_CANNOT_BE_ACCELERATED_ON_TARGET =\n 'TRANSFORM_RELATED_PROPERTY_CANNOT_BE_ACCELERATED_ON_TARGET',\n TRANSFROM_BOX_SIZE_DEPENDENT = 'TRANSFROM_BOX_SIZE_DEPENDENT',\n FILTER_RELATED_PROPERTY_MAY_MOVE_PIXELS = 'FILTER_RELATED_PROPERTY_MAY_MOVE_PIXELS',\n UNSUPPORTED_CSS_PROPERTY = 'UNSUPPORTED_CSS_PROPERTY',\n MIXED_KEYFRAME_VALUE_TYPES = 'MIXED_KEYFRAME_VALUE_TYPES',\n TIMELINE_SOURCE_HAS_INVALID_COMPOSITING_STATE = 'TIMELINE_SOURCE_HAS_INVALID_COMPOSITING_STATE',\n ANIMATION_HAS_NO_VISIBLE_CHANGE = 'ANIMATION_HAS_NO_VISIBLE_CHANGE',\n AFFECTS_IMPORTANT_PROPERTY = 'AFFECTS_IMPORTANT_PROPERTY',\n SVG_TARGET_HAS_INDEPENDENT_TRANSFORM_PROPERTY = 'SVG_TARGET_HAS_INDEPENDENT_TRANSFORM_PROPERTY',\n}\n\nexport enum LayoutShiftType {\n WEB_FONT = 0,\n IFRAMES = 1,\n ANIMATIONS = 2,\n UNSIZED_IMAGE = 3,\n}\n\nexport type LayoutShiftItem = {\n type: LayoutShiftType.UNSIZED_IMAGE,\n description: Platform.UIString.LocalizedString,\n url: string,\n backendNodeId: Protocol.DOM.BackendNodeId,\n frame: string,\n}|{\n type: Exclude<LayoutShiftType, LayoutShiftType.UNSIZED_IMAGE>,\n description: Platform.UIString.LocalizedString,\n};\n\nexport interface NoncompositedAnimationFailure {\n /**\n * Animation name.\n */\n name?: string;\n /**\n * Failure reason based on mask number defined in\n * https://source.chromium.org/search?q=f:compositor_animations.h%20%22enum%20FailureReason%22.\n */\n failureReasons: AnimationFailureReasons[];\n /**\n * Unsupported properties.\n */\n unsupportedProperties?: Types.Events.Animation['args']['data']['unsupportedProperties'];\n /**\n * Animation event.\n */\n animation?: Types.Events.SyntheticAnimationPair;\n}\n\n/**\n * Each failure reason is represented by a bit flag. The bit shift operator '<<' is used to define\n * which bit corresponds to each failure reason.\n * https://source.chromium.org/search?q=f:compositor_animations.h%20%22enum%20FailureReason%22\n */\nconst ACTIONABLE_FAILURE_REASONS: Array<{\n flag: number,\n failure: AnimationFailureReasons,\n}> =\n [\n {\n flag: 1 << 0,\n failure: AnimationFailureReasons.ACCELERATED_ANIMATIONS_DISABLED,\n },\n {\n flag: 1 << 1,\n failure: AnimationFailureReasons.EFFECT_SUPPRESSED_BY_DEVTOOLS,\n },\n {\n flag: 1 << 2,\n failure: AnimationFailureReasons.INVALID_ANIMATION_OR_EFFECT,\n },\n {\n flag: 1 << 3,\n failure: AnimationFailureReasons.EFFECT_HAS_UNSUPPORTED_TIMING_PARAMS,\n },\n {\n flag: 1 << 4,\n failure: AnimationFailureReasons.EFFECT_HAS_NON_REPLACE_COMPOSITE_MODE,\n },\n {\n flag: 1 << 5,\n failure: AnimationFailureReasons.TARGET_HAS_INVALID_COMPOSITING_STATE,\n },\n {\n flag: 1 << 6,\n failure: AnimationFailureReasons.TARGET_HAS_INCOMPATIBLE_ANIMATIONS,\n },\n {\n flag: 1 << 7,\n failure: AnimationFailureReasons.TARGET_HAS_CSS_OFFSET,\n },\n // The failure 1 << 8 is marked as obsolete in Blink\n {\n flag: 1 << 9,\n failure: AnimationFailureReasons.ANIMATION_AFFECTS_NON_CSS_PROPERTIES,\n },\n {\n flag: 1 << 10,\n failure: AnimationFailureReasons.TRANSFORM_RELATED_PROPERTY_CANNOT_BE_ACCELERATED_ON_TARGET,\n },\n {\n flag: 1 << 11,\n failure: AnimationFailureReasons.TRANSFROM_BOX_SIZE_DEPENDENT,\n },\n {\n flag: 1 << 12,\n failure: AnimationFailureReasons.FILTER_RELATED_PROPERTY_MAY_MOVE_PIXELS,\n },\n {\n flag: 1 << 13,\n failure: AnimationFailureReasons.UNSUPPORTED_CSS_PROPERTY,\n },\n // The failure 1 << 14 is marked as obsolete in Blink\n {\n flag: 1 << 15,\n failure: AnimationFailureReasons.MIXED_KEYFRAME_VALUE_TYPES,\n },\n {\n flag: 1 << 16,\n failure: AnimationFailureReasons.TIMELINE_SOURCE_HAS_INVALID_COMPOSITING_STATE,\n },\n {\n flag: 1 << 17,\n failure: AnimationFailureReasons.ANIMATION_HAS_NO_VISIBLE_CHANGE,\n },\n {\n flag: 1 << 18,\n failure: AnimationFailureReasons.AFFECTS_IMPORTANT_PROPERTY,\n },\n {\n flag: 1 << 19,\n failure: AnimationFailureReasons.SVG_TARGET_HAS_INDEPENDENT_TRANSFORM_PROPERTY,\n },\n ] as const;\n\n// 500ms window.\n// Use this window to consider events and requests that may have caused a layout shift.\nconst ROOT_CAUSE_WINDOW = Helpers.Timing.secondsToMicro(Types.Timing.Seconds(0.5));\n\nexport interface UnsizedImage {\n backendNodeId: Protocol.DOM.BackendNodeId;\n paintImageEvent: Types.Events.PaintImage;\n}\n\nexport interface IframeRootCause {\n frame: string;\n url?: string;\n}\n\nexport interface LayoutShiftRootCausesData {\n iframes: IframeRootCause[];\n webFonts: Types.Events.SyntheticNetworkRequest[];\n nonCompositedAnimations: NoncompositedAnimationFailure[];\n unsizedImages: UnsizedImage[];\n}\n\n/**\n * Returns if an event happens within the root cause window, before the target event.\n * ROOT_CAUSE_WINDOW v target event\n * |------------------------|=======================\n */\nfunction isInRootCauseWindow(event: Types.Events.Event, targetEvent: Types.Events.Event): boolean {\n const eventEnd = event.dur ? event.ts + event.dur : event.ts;\n return eventEnd < targetEvent.ts && eventEnd >= targetEvent.ts - ROOT_CAUSE_WINDOW;\n}\n\nexport function getNonCompositedFailure(animationEvent: Types.Events.SyntheticAnimationPair):\n NoncompositedAnimationFailure[] {\n const failures: NoncompositedAnimationFailure[] = [];\n const beginEvent = animationEvent.args.data.beginEvent;\n const instantEvents = animationEvent.args.data.instantEvents || [];\n /**\n * Animation events containing composite information are ASYNC_NESTABLE_INSTANT ('n').\n * An animation may also contain multiple 'n' events, so we look through those with useful non-composited data.\n */\n for (const event of instantEvents) {\n const failureMask = event.args.data.compositeFailed;\n const unsupportedProperties = event.args.data.unsupportedProperties;\n if (!failureMask) {\n continue;\n }\n const failureReasons =\n ACTIONABLE_FAILURE_REASONS.filter(reason => failureMask & reason.flag).map(reason => reason.failure);\n const failure: NoncompositedAnimationFailure = {\n name: beginEvent.args.data.displayName,\n failureReasons,\n unsupportedProperties,\n animation: animationEvent,\n };\n failures.push(failure);\n }\n return failures;\n}\n\nfunction getNonCompositedFailureRootCauses(\n animationEvents: Types.Events.SyntheticAnimationPair[],\n prePaintEvents: Types.Events.PrePaint[],\n shiftsByPrePaint: Map<Types.Events.PrePaint, Types.Events.SyntheticLayoutShift[]>,\n rootCausesByShift: Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>,\n ): NoncompositedAnimationFailure[] {\n const allAnimationFailures: NoncompositedAnimationFailure[] = [];\n for (const animation of animationEvents) {\n /**\n * Animation events containing composite information are ASYNC_NESTABLE_INSTANT ('n').\n * An animation may also contain multiple 'n' events, so we look through those with useful non-composited data.\n */\n const failures = getNonCompositedFailure(animation);\n if (!failures) {\n continue;\n }\n allAnimationFailures.push(...failures);\n\n const nextPrePaint = getNextEvent(prePaintEvents, animation) as Types.Events.PrePaint | null;\n // If no following prePaint, this is not a root cause.\n if (!nextPrePaint) {\n continue;\n }\n\n // If the animation event is outside the ROOT_CAUSE_WINDOW, it could not be a root cause.\n if (!isInRootCauseWindow(animation, nextPrePaint)) {\n continue;\n }\n\n const shifts = shiftsByPrePaint.get(nextPrePaint);\n // if no layout shift(s), this is not a root cause.\n if (!shifts) {\n continue;\n }\n\n for (const shift of shifts) {\n const rootCausesForShift = rootCausesByShift.get(shift);\n if (!rootCausesForShift) {\n throw new Error('Unaccounted shift');\n }\n rootCausesForShift.nonCompositedAnimations.push(...failures);\n }\n }\n\n return allAnimationFailures;\n}\n\n/**\n * Given an array of layout shift and PrePaint events, returns a mapping from\n * PrePaint events to layout shifts dispatched within it.\n */\nfunction getShiftsByPrePaintEvents(\n layoutShifts: Types.Events.SyntheticLayoutShift[],\n prePaintEvents: Types.Events.PrePaint[],\n ): Map<Types.Events.PrePaint, Types.Events.SyntheticLayoutShift[]> {\n // Maps from PrePaint events to LayoutShifts that occurred in each one.\n const shiftsByPrePaint = new Map<Types.Events.PrePaint, Types.Events.SyntheticLayoutShift[]>();\n\n // Associate all shifts to their corresponding PrePaint.\n for (const prePaintEvent of prePaintEvents) {\n const firstShiftIndex =\n Platform.ArrayUtilities.nearestIndexFromBeginning(layoutShifts, shift => shift.ts >= prePaintEvent.ts);\n if (firstShiftIndex === null) {\n // No layout shifts registered after this PrePaint start. Continue.\n continue;\n }\n for (let i = firstShiftIndex; i < layoutShifts.length; i++) {\n const shift = layoutShifts[i];\n if (shift.ts >= prePaintEvent.ts && shift.ts <= prePaintEvent.ts + prePaintEvent.dur) {\n const shiftsInPrePaint = Platform.MapUtilities.getWithDefault(shiftsByPrePaint, prePaintEvent, () => []);\n shiftsInPrePaint.push(shift);\n }\n if (shift.ts > prePaintEvent.ts + prePaintEvent.dur) {\n // Reached all layoutShifts of this PrePaint. Break out to continue with the next prePaint event.\n break;\n }\n }\n }\n return shiftsByPrePaint;\n}\n\n/**\n * Given a source event list, this returns the first event of that list that directly follows the target event.\n */\nfunction getNextEvent(sourceEvents: Types.Events.Event[], targetEvent: Types.Events.Event): Types.Events.Event|\n undefined {\n const index = Platform.ArrayUtilities.nearestIndexFromBeginning(\n sourceEvents, source => source.ts > targetEvent.ts + (targetEvent.dur || 0));\n // No PrePaint event registered after this event\n if (index === null) {\n return undefined;\n }\n\n return sourceEvents[index];\n}\n\n/**\n * An Iframe is considered a root cause if the iframe event occurs before a prePaint event\n * and within this prePaint event a layout shift(s) occurs.\n */\nfunction getIframeRootCauses(\n data: Handlers.Types.HandlerData, iframeCreatedEvents: readonly Types.Events.RenderFrameImplCreateChildFrame[],\n prePaintEvents: Types.Events.PrePaint[],\n shiftsByPrePaint: Map<Types.Events.PrePaint, Types.Events.SyntheticLayoutShift[]>,\n rootCausesByShift: Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>,\n domLoadingEvents: readonly Types.Events.DomLoading[]):\n Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData> {\n for (const iframeEvent of iframeCreatedEvents) {\n const nextPrePaint = getNextEvent(prePaintEvents, iframeEvent) as Types.Events.PrePaint | null;\n // If no following prePaint, this is not a root cause.\n if (!nextPrePaint) {\n continue;\n }\n const shifts = shiftsByPrePaint.get(nextPrePaint);\n // if no layout shift(s), this is not a root cause.\n if (!shifts) {\n continue;\n }\n for (const shift of shifts) {\n const rootCausesForShift = rootCausesByShift.get(shift);\n if (!rootCausesForShift) {\n throw new Error('Unaccounted shift');\n }\n\n // Look for the first dom event that occurs within the bounds of the iframe event.\n // This contains the frame id.\n const domEvent = domLoadingEvents.find(e => {\n const maxIframe = Types.Timing.Micro(iframeEvent.ts + (iframeEvent.dur ?? 0));\n return e.ts >= iframeEvent.ts && e.ts <= maxIframe;\n });\n if (domEvent?.args.frame) {\n const frame = domEvent.args.frame;\n\n let url;\n const processes = data.Meta.rendererProcessesByFrame.get(frame);\n if (processes && processes.size > 0) {\n url = [...processes.values()][0]?.[0].frame.url;\n }\n\n rootCausesForShift.iframes.push({frame, url});\n }\n }\n }\n return rootCausesByShift;\n}\n\n/**\n * An unsized image is considered a root cause if its PaintImage can be correlated to a\n * layout shift. We can correlate PaintImages with unsized images by their matching nodeIds.\n * X <- layout shift\n * |----------------|\n * ^ PrePaint event |-----|\n * ^ PaintImage\n */\nfunction getUnsizedImageRootCauses(\n unsizedImageEvents: readonly Types.Events.LayoutImageUnsized[], paintImageEvents: Types.Events.PaintImage[],\n shiftsByPrePaint: Map<Types.Events.PrePaint, Types.Events.SyntheticLayoutShift[]>,\n rootCausesByShift: Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>):\n Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData> {\n shiftsByPrePaint.forEach((shifts, prePaint) => {\n const paintImage = getNextEvent(paintImageEvents, prePaint) as Types.Events.PaintImage | null;\n if (!paintImage) {\n return;\n }\n // The unsized image corresponds to this PaintImage.\n const matchingNode =\n unsizedImageEvents.find(unsizedImage => unsizedImage.args.data.nodeId === paintImage.args.data.nodeId);\n if (!matchingNode) {\n return;\n }\n // The unsized image is a potential root cause of all the shifts of this prePaint.\n for (const shift of shifts) {\n const rootCausesForShift = rootCausesByShift.get(shift);\n if (!rootCausesForShift) {\n throw new Error('Unaccounted shift');\n }\n rootCausesForShift.unsizedImages.push({\n backendNodeId: matchingNode.args.data.nodeId,\n paintImageEvent: paintImage,\n });\n }\n });\n return rootCausesByShift;\n}\n\nexport function isCLSCulpritsInsight(insight: InsightModel): insight is CLSCulpritsInsightModel {\n return insight.insightKey === InsightKeys.CLS_CULPRITS;\n}\n\n/**\n * A font request is considered a root cause if the request occurs before a prePaint event\n * and within this prePaint event a layout shift(s) occurs. Additionally, this font request should\n * happen within the ROOT_CAUSE_WINDOW of the prePaint event.\n */\nfunction getFontRootCauses(\n networkRequests: Types.Events.SyntheticNetworkRequest[], prePaintEvents: Types.Events.PrePaint[],\n shiftsByPrePaint: Map<Types.Events.PrePaint, Types.Events.SyntheticLayoutShift[]>,\n rootCausesByShift: Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>):\n Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData> {\n const fontRequests =\n networkRequests.filter(req => req.args.data.resourceType === 'Font' && req.args.data.mimeType.startsWith('font'));\n\n for (const req of fontRequests) {\n const nextPrePaint = getNextEvent(prePaintEvents, req) as Types.Events.PrePaint | null;\n if (!nextPrePaint) {\n continue;\n }\n\n // If the req is outside the ROOT_CAUSE_WINDOW, it could not be a root cause.\n if (!isInRootCauseWindow(req, nextPrePaint)) {\n continue;\n }\n\n // Get the shifts that belong to this prepaint\n const shifts = shiftsByPrePaint.get(nextPrePaint);\n\n // if no layout shift(s) in this prePaint, the request is not a root cause.\n if (!shifts) {\n continue;\n }\n // Include the root cause to the shifts in this prePaint.\n for (const shift of shifts) {\n const rootCausesForShift = rootCausesByShift.get(shift);\n if (!rootCausesForShift) {\n throw new Error('Unaccounted shift');\n }\n rootCausesForShift.webFonts.push(req);\n }\n }\n return rootCausesByShift;\n}\n\n/**\n * Returns the top 3 shift root causes based on the given cluster.\n */\nfunction getTopCulprits(\n cluster: Types.Events.SyntheticLayoutShiftCluster,\n culpritsByShift: Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>): LayoutShiftItem[] {\n const MAX_TOP_CULPRITS = 3;\n const causes: LayoutShiftItem[] = [];\n\n const shifts = cluster.events;\n for (const shift of shifts) {\n const culprits = culpritsByShift.get(shift);\n if (!culprits) {\n continue;\n }\n\n const fontReq = culprits.webFonts;\n const iframes = culprits.iframes;\n const animations = culprits.nonCompositedAnimations;\n const unsizedImages = culprits.unsizedImages;\n\n for (let i = 0; i < fontReq.length && causes.length < MAX_TOP_CULPRITS; i++) {\n causes.push({type: LayoutShiftType.WEB_FONT, description: i18nString(UIStrings.webFont)});\n }\n for (let i = 0; i < iframes.length && causes.length < MAX_TOP_CULPRITS; i++) {\n causes.push({type: LayoutShiftType.IFRAMES, description: i18nString(UIStrings.injectedIframe)});\n }\n for (let i = 0; i < animations.length && causes.length < MAX_TOP_CULPRITS; i++) {\n causes.push({type: LayoutShiftType.ANIMATIONS, description: i18nString(UIStrings.animation)});\n }\n for (let i = 0; i < unsizedImages.length && causes.length < MAX_TOP_CULPRITS; i++) {\n causes.push({\n type: LayoutShiftType.UNSIZED_IMAGE,\n description: i18nString(UIStrings.unsizedImage),\n url: unsizedImages[i].paintImageEvent.args.data.url || '',\n backendNodeId: unsizedImages[i].backendNodeId,\n frame: unsizedImages[i].paintImageEvent.args.data.frame || '',\n });\n }\n\n if (causes.length >= MAX_TOP_CULPRITS) {\n break;\n }\n }\n\n return causes.slice(0, MAX_TOP_CULPRITS);\n}\n\nfunction finalize(partialModel: PartialInsightModel<CLSCulpritsInsightModel>): CLSCulpritsInsightModel {\n let state: CLSCulpritsInsightModel['state'] = 'pass';\n if (partialModel.worstCluster) {\n const classification = Handlers.ModelHandlers.LayoutShifts.scoreClassificationForLayoutShift(\n partialModel.worstCluster.clusterCumulativeScore);\n if (classification === Handlers.ModelHandlers.PageLoadMetrics.ScoreClassification.GOOD) {\n state = 'informative';\n } else {\n state = 'fail';\n }\n }\n\n return {\n insightKey: InsightKeys.CLS_CULPRITS,\n strings: UIStrings,\n title: i18nString(UIStrings.title),\n description: i18nString(UIStrings.description),\n docs: 'https://developer.chrome.com/docs/performance/insights/cls-culprit',\n category: InsightCategory.CLS,\n state,\n ...partialModel,\n };\n}\n\nexport function generateInsight(data: Handlers.Types.HandlerData, context: InsightSetContext): CLSCulpritsInsightModel {\n const isWithinContext = (event: Types.Events.Event): boolean => Helpers.Timing.eventIsInBounds(event, context.bounds);\n\n const compositeAnimationEvents = data.Animations.animations.filter(isWithinContext);\n const iframeEvents = data.LayoutShifts.renderFrameImplCreateChildFrameEvents.filter(isWithinContext);\n const networkRequests = data.NetworkRequests.byTime.filter(isWithinContext);\n const domLoadingEvents = data.LayoutShifts.domLoadingEvents.filter(isWithinContext);\n const unsizedImageEvents = data.LayoutShifts.layoutImageUnsizedEvents.filter(isWithinContext);\n\n const clusters = data.LayoutShifts.clusters.filter(isWithinContext);\n const clustersByScore = clusters.toSorted((a, b) => b.clusterCumulativeScore - a.clusterCumulativeScore);\n const worstCluster = clustersByScore.at(0);\n const layoutShifts = clusters.flatMap(cluster => cluster.events);\n const prePaintEvents = data.LayoutShifts.prePaintEvents.filter(isWithinContext);\n const paintImageEvents = data.LayoutShifts.paintImageEvents.filter(isWithinContext);\n\n // Get root causes.\n const rootCausesByShift = new Map<Types.Events.SyntheticLayoutShift, LayoutShiftRootCausesData>();\n const shiftsByPrePaint = getShiftsByPrePaintEvents(layoutShifts, prePaintEvents);\n\n for (const shift of layoutShifts) {\n rootCausesByShift.set(shift, {iframes: [], webFonts: [], nonCompositedAnimations: [], unsizedImages: []});\n }\n\n // Populate root causes for rootCausesByShift.\n getIframeRootCauses(data, iframeEvents, prePaintEvents, shiftsByPrePaint, rootCausesByShift, domLoadingEvents);\n getFontRootCauses(networkRequests, prePaintEvents, shiftsByPrePaint, rootCausesByShift);\n getUnsizedImageRootCauses(unsizedImageEvents, paintImageEvents, shiftsByPrePaint, rootCausesByShift);\n const animationFailures =\n getNonCompositedFailureRootCauses(compositeAnimationEvents, prePaintEvents, shiftsByPrePaint, rootCausesByShift);\n\n const relatedEvents: Types.Events.Event[] = [...layoutShifts];\n if (worstCluster) {\n relatedEvents.push(worstCluster);\n }\n\n const topCulpritsByCluster = new Map<Types.Events.SyntheticLayoutShiftCluster, LayoutShiftItem[]>();\n for (const cluster of clusters) {\n topCulpritsByCluster.set(cluster, getTopCulprits(cluster, rootCausesByShift));\n }\n\n return finalize({\n relatedEvents,\n animationFailures,\n shifts: rootCausesByShift,\n clusters,\n worstCluster,\n topCulpritsByCluster,\n });\n}\n\nexport function createOverlays(model: CLSCulpritsInsightModel): Types.Overlays.Overlay[] {\n const clustersByScore = model.clusters.toSorted((a, b) => b.clusterCumulativeScore - a.clusterCumulativeScore) ?? [];\n const worstCluster = clustersByScore[0];\n if (!worstCluster) {\n return [];\n }\n\n const range = Types.Timing.Micro(worstCluster.dur ?? 0);\n const max = Types.Timing.Micro(worstCluster.ts + range);\n\n return [{\n type: 'TIMESPAN_BREAKDOWN',\n sections: [\n {\n bounds: {min: worstCluster.ts, range, max},\n label: i18nString(UIStrings.worstLayoutShiftCluster),\n showDuration: false,\n },\n ],\n // This allows for the overlay to sit over the layout shift.\n entry: worstCluster.events[0],\n renderLocation: 'ABOVE_EVENT',\n }];\n}\n"]}
@@ -7,28 +7,28 @@ export declare const UIStrings: {
7
7
  /**
8
8
  * @description Title of an insight that provides information and suggestions of resources that could improve their caching.
9
9
  */
10
- readonly title: "Use efficient cache lifetimes";
10
+ readonly title: 'Use efficient cache lifetimes';
11
11
  /**
12
12
  * @description Text to tell the user about how caching can help improve performance.
13
13
  */
14
- readonly description: "A long cache lifetime can speed up repeat visits to your page. [Learn more about caching](https://developer.chrome.com/docs/performance/insights/cache).";
14
+ readonly description: 'A long cache lifetime can speed up repeat visits to your page. [Learn more about caching](https://developer.chrome.com/docs/performance/insights/cache).';
15
15
  /**
16
16
  * @description Column for a font loaded by the page to render text.
17
17
  */
18
- readonly requestColumn: "Request";
18
+ readonly requestColumn: 'Request';
19
19
  /**
20
20
  * @description Column for a resource cache's Time To Live.
21
21
  */
22
- readonly cacheTTL: "Cache TTL";
22
+ readonly cacheTTL: 'Cache TTL';
23
23
  /**
24
24
  * @description Text describing that there were no requests found that need caching.
25
25
  */
26
- readonly noRequestsToCache: "No requests with inefficient cache policies";
26
+ readonly noRequestsToCache: 'No requests with inefficient cache policies';
27
27
  /**
28
28
  * @description Table row value representing the remaining items not shown in the table due to size constraints. This row will always represent at least 2 items.
29
29
  * @example {5} PH1
30
30
  */
31
- readonly others: "{PH1} others";
31
+ readonly others: '{PH1} others';
32
32
  };
33
33
  export declare const i18nString: i18n.LocalizeString;
34
34
  export type CacheInsightModel = InsightModel<typeof UIStrings, {