lighthouse 12.1.0 → 12.2.0

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 (436) hide show
  1. package/cli/cli-flags.d.ts +2 -2
  2. package/cli/cli-flags.js +1 -1
  3. package/cli/sentry-prompt.js +2 -2
  4. package/cli/test/smokehouse/frontends/lib.d.ts +1 -1
  5. package/cli/test/smokehouse/lib/concurrent-mapper.d.ts +6 -6
  6. package/cli/test/smokehouse/lighthouse-runners/bundle.d.ts +1 -1
  7. package/cli/test/smokehouse/lighthouse-runners/cli.d.ts +1 -2
  8. package/cli/test/smokehouse/lighthouse-runners/devtools.d.ts +1 -1
  9. package/cli/test/smokehouse/report-assert.d.ts +0 -1
  10. package/cli/test/smokehouse/version-check.d.ts +3 -3
  11. package/core/audits/accessibility/accesskeys.d.ts +3 -3
  12. package/core/audits/accessibility/aria-allowed-attr.d.ts +3 -3
  13. package/core/audits/accessibility/aria-allowed-role.d.ts +3 -3
  14. package/core/audits/accessibility/aria-command-name.d.ts +3 -3
  15. package/core/audits/accessibility/aria-conditional-attr.d.ts +3 -3
  16. package/core/audits/accessibility/aria-deprecated-role.d.ts +3 -3
  17. package/core/audits/accessibility/aria-dialog-name.d.ts +3 -3
  18. package/core/audits/accessibility/aria-hidden-body.d.ts +3 -3
  19. package/core/audits/accessibility/aria-hidden-focus.d.ts +3 -3
  20. package/core/audits/accessibility/aria-input-field-name.d.ts +3 -3
  21. package/core/audits/accessibility/aria-meter-name.d.ts +3 -3
  22. package/core/audits/accessibility/aria-progressbar-name.d.ts +3 -3
  23. package/core/audits/accessibility/aria-prohibited-attr.d.ts +3 -3
  24. package/core/audits/accessibility/aria-required-attr.d.ts +3 -3
  25. package/core/audits/accessibility/aria-required-children.d.ts +3 -3
  26. package/core/audits/accessibility/aria-required-parent.d.ts +3 -3
  27. package/core/audits/accessibility/aria-roles.d.ts +3 -3
  28. package/core/audits/accessibility/aria-text.d.ts +3 -3
  29. package/core/audits/accessibility/aria-toggle-field-name.d.ts +3 -3
  30. package/core/audits/accessibility/aria-tooltip-name.d.ts +3 -3
  31. package/core/audits/accessibility/aria-treeitem-name.d.ts +3 -3
  32. package/core/audits/accessibility/aria-valid-attr-value.d.ts +3 -3
  33. package/core/audits/accessibility/aria-valid-attr.d.ts +3 -3
  34. package/core/audits/accessibility/axe-audit.d.ts +1 -1
  35. package/core/audits/accessibility/button-name.d.ts +3 -3
  36. package/core/audits/accessibility/bypass.d.ts +3 -3
  37. package/core/audits/accessibility/color-contrast.d.ts +3 -3
  38. package/core/audits/accessibility/definition-list.d.ts +3 -3
  39. package/core/audits/accessibility/dlitem.d.ts +3 -3
  40. package/core/audits/accessibility/document-title.d.ts +3 -3
  41. package/core/audits/accessibility/duplicate-id-aria.d.ts +3 -3
  42. package/core/audits/accessibility/empty-heading.d.ts +3 -3
  43. package/core/audits/accessibility/form-field-multiple-labels.d.ts +3 -3
  44. package/core/audits/accessibility/frame-title.d.ts +3 -3
  45. package/core/audits/accessibility/heading-order.d.ts +3 -3
  46. package/core/audits/accessibility/html-has-lang.d.ts +3 -3
  47. package/core/audits/accessibility/html-lang-valid.d.ts +3 -3
  48. package/core/audits/accessibility/html-xml-lang-mismatch.d.ts +3 -3
  49. package/core/audits/accessibility/identical-links-same-purpose.d.ts +3 -3
  50. package/core/audits/accessibility/image-alt.d.ts +3 -3
  51. package/core/audits/accessibility/image-redundant-alt.d.ts +3 -3
  52. package/core/audits/accessibility/input-button-name.d.ts +3 -3
  53. package/core/audits/accessibility/input-image-alt.d.ts +3 -3
  54. package/core/audits/accessibility/label-content-name-mismatch.d.ts +3 -3
  55. package/core/audits/accessibility/label.d.ts +3 -3
  56. package/core/audits/accessibility/landmark-one-main.d.ts +3 -3
  57. package/core/audits/accessibility/link-in-text-block.d.ts +3 -3
  58. package/core/audits/accessibility/link-name.d.ts +3 -3
  59. package/core/audits/accessibility/list.d.ts +3 -3
  60. package/core/audits/accessibility/listitem.d.ts +3 -3
  61. package/core/audits/accessibility/meta-refresh.d.ts +3 -3
  62. package/core/audits/accessibility/meta-viewport.d.ts +3 -3
  63. package/core/audits/accessibility/object-alt.d.ts +3 -3
  64. package/core/audits/accessibility/select-name.d.ts +3 -3
  65. package/core/audits/accessibility/skip-link.d.ts +3 -3
  66. package/core/audits/accessibility/tabindex.d.ts +3 -3
  67. package/core/audits/accessibility/table-duplicate-name.d.ts +3 -3
  68. package/core/audits/accessibility/table-fake-caption.d.ts +3 -3
  69. package/core/audits/accessibility/target-size.d.ts +3 -3
  70. package/core/audits/accessibility/td-has-header.d.ts +3 -3
  71. package/core/audits/accessibility/td-headers-attr.d.ts +3 -3
  72. package/core/audits/accessibility/th-has-data-cells.d.ts +3 -3
  73. package/core/audits/accessibility/valid-lang.d.ts +3 -3
  74. package/core/audits/accessibility/video-caption.d.ts +3 -3
  75. package/core/audits/audit.d.ts +17 -17
  76. package/core/audits/autocomplete.d.ts +9 -9
  77. package/core/audits/bf-cache.d.ts +10 -10
  78. package/core/audits/bootup-time.d.ts +7 -7
  79. package/core/audits/byte-efficiency/byte-efficiency-audit.d.ts +6 -8
  80. package/core/audits/byte-efficiency/byte-efficiency-audit.js +3 -6
  81. package/core/audits/byte-efficiency/duplicated-javascript.d.ts +4 -4
  82. package/core/audits/byte-efficiency/efficient-animated-content.d.ts +3 -4
  83. package/core/audits/byte-efficiency/legacy-javascript.d.ts +7 -8
  84. package/core/audits/byte-efficiency/modern-image-formats.d.ts +3 -3
  85. package/core/audits/byte-efficiency/offscreen-images.d.ts +3 -4
  86. package/core/audits/byte-efficiency/render-blocking-resources.d.ts +5 -9
  87. package/core/audits/byte-efficiency/render-blocking-resources.js +10 -16
  88. package/core/audits/byte-efficiency/total-byte-weight.d.ts +4 -4
  89. package/core/audits/byte-efficiency/unminified-css.d.ts +3 -3
  90. package/core/audits/byte-efficiency/unminified-javascript.d.ts +3 -3
  91. package/core/audits/byte-efficiency/unused-css-rules.d.ts +3 -3
  92. package/core/audits/byte-efficiency/unused-javascript.d.ts +3 -3
  93. package/core/audits/byte-efficiency/uses-long-cache-ttl.d.ts +4 -6
  94. package/core/audits/byte-efficiency/uses-optimized-images.d.ts +3 -3
  95. package/core/audits/byte-efficiency/uses-responsive-images-snapshot.d.ts +4 -4
  96. package/core/audits/byte-efficiency/uses-responsive-images.d.ts +4 -5
  97. package/core/audits/byte-efficiency/uses-text-compression.d.ts +3 -3
  98. package/core/audits/critical-request-chains.d.ts +3 -3
  99. package/core/audits/csp-xss.d.ts +8 -8
  100. package/core/audits/deprecations.d.ts +6 -6
  101. package/core/audits/dobetterweb/charset.d.ts +3 -3
  102. package/core/audits/dobetterweb/doctype.d.ts +9 -9
  103. package/core/audits/dobetterweb/dom-size.d.ts +9 -9
  104. package/core/audits/dobetterweb/geolocation-on-start.d.ts +3 -3
  105. package/core/audits/dobetterweb/inspector-issues.d.ts +6 -6
  106. package/core/audits/dobetterweb/js-libraries.d.ts +3 -3
  107. package/core/audits/dobetterweb/no-document-write.d.ts +3 -3
  108. package/core/audits/dobetterweb/notification-on-start.d.ts +3 -3
  109. package/core/audits/dobetterweb/paste-preventing-inputs.d.ts +3 -3
  110. package/core/audits/dobetterweb/uses-http2.d.ts +7 -11
  111. package/core/audits/dobetterweb/uses-http2.js +2 -5
  112. package/core/audits/dobetterweb/uses-passive-event-listeners.d.ts +3 -3
  113. package/core/audits/errors-in-console.d.ts +4 -4
  114. package/core/audits/font-display.d.ts +4 -4
  115. package/core/audits/image-aspect-ratio.d.ts +5 -5
  116. package/core/audits/image-size-responsive.d.ts +7 -7
  117. package/core/audits/is-on-https.d.ts +10 -10
  118. package/core/audits/largest-contentful-paint-element.d.ts +9 -9
  119. package/core/audits/layout-shifts.d.ts +9 -9
  120. package/core/audits/lcp-lazy-loaded.d.ts +3 -3
  121. package/core/audits/long-tasks.d.ts +11 -11
  122. package/core/audits/long-tasks.js +5 -5
  123. package/core/audits/mainthread-work-breakdown.d.ts +5 -5
  124. package/core/audits/metrics/cumulative-layout-shift.d.ts +1 -1
  125. package/core/audits/metrics/first-contentful-paint.d.ts +1 -1
  126. package/core/audits/metrics/first-meaningful-paint.d.ts +1 -1
  127. package/core/audits/metrics/interaction-to-next-paint.d.ts +1 -1
  128. package/core/audits/metrics/interactive.d.ts +1 -1
  129. package/core/audits/metrics/largest-contentful-paint.d.ts +1 -1
  130. package/core/audits/metrics/max-potential-fid.d.ts +2 -4
  131. package/core/audits/metrics/speed-index.d.ts +1 -1
  132. package/core/audits/metrics/total-blocking-time.d.ts +1 -1
  133. package/core/audits/network-rtt.d.ts +2 -2
  134. package/core/audits/network-server-latency.d.ts +2 -2
  135. package/core/audits/non-composited-animations.d.ts +9 -9
  136. package/core/audits/oopif-iframe-test-audit.d.ts +5 -5
  137. package/core/audits/preload-fonts.d.ts +3 -3
  138. package/core/audits/prioritize-lcp-image.d.ts +7 -7
  139. package/core/audits/redirects-http.d.ts +3 -3
  140. package/core/audits/redirects.d.ts +2 -3
  141. package/core/audits/resource-summary.d.ts +1 -1
  142. package/core/audits/screenshot-thumbnails.d.ts +2 -3
  143. package/core/audits/script-treemap-data.d.ts +1 -1
  144. package/core/audits/seo/canonical.d.ts +8 -8
  145. package/core/audits/seo/crawlable-anchors.d.ts +4 -4
  146. package/core/audits/seo/font-size.d.ts +11 -11
  147. package/core/audits/seo/hreflang.d.ts +6 -6
  148. package/core/audits/seo/http-status-code.d.ts +3 -3
  149. package/core/audits/seo/is-crawlable.d.ts +9 -10
  150. package/core/audits/seo/link-text.d.ts +4 -4
  151. package/core/audits/seo/manual/structured-data.d.ts +2 -2
  152. package/core/audits/seo/meta-description.d.ts +4 -4
  153. package/core/audits/seo/robots-txt.d.ts +6 -6
  154. package/core/audits/server-response-time.d.ts +4 -4
  155. package/core/audits/third-party-cookies.d.ts +4 -4
  156. package/core/audits/third-party-facades.d.ts +11 -12
  157. package/core/audits/third-party-summary.d.ts +5 -6
  158. package/core/audits/third-party-summary.js +7 -4
  159. package/core/audits/unsized-images.d.ts +3 -3
  160. package/core/audits/user-timings.d.ts +6 -6
  161. package/core/audits/uses-rel-preconnect.d.ts +5 -5
  162. package/core/audits/uses-rel-preload.d.ts +7 -7
  163. package/core/audits/uses-rel-preload.js +8 -6
  164. package/core/audits/valid-source-maps.d.ts +6 -7
  165. package/core/audits/viewport.d.ts +4 -4
  166. package/core/audits/work-during-interaction.d.ts +11 -12
  167. package/core/computed/computed-artifact.d.ts +2 -2
  168. package/core/computed/critical-request-chains.d.ts +9 -11
  169. package/core/computed/critical-request-chains.js +6 -6
  170. package/core/computed/document-urls.d.ts +3 -8
  171. package/core/computed/document-urls.js +1 -1
  172. package/core/computed/entity-classification.d.ts +6 -8
  173. package/core/computed/image-records.d.ts +3 -5
  174. package/core/computed/js-bundles.d.ts +2 -4
  175. package/core/computed/lcp-image-record.d.ts +3 -5
  176. package/core/computed/load-simulator.d.ts +7 -11
  177. package/core/computed/load-simulator.js +1 -1
  178. package/core/computed/main-resource.d.ts +5 -7
  179. package/core/computed/main-resource.js +1 -1
  180. package/core/computed/main-thread-tasks.d.ts +1 -3
  181. package/core/computed/metrics/cumulative-layout-shift.d.ts +2 -14
  182. package/core/computed/metrics/first-contentful-paint-all-frames.d.ts +1 -3
  183. package/core/computed/metrics/first-contentful-paint.d.ts +1 -3
  184. package/core/computed/metrics/interactive.d.ts +1 -3
  185. package/core/computed/metrics/lantern-first-contentful-paint.d.ts +3 -7
  186. package/core/computed/metrics/lantern-first-contentful-paint.js +3 -5
  187. package/core/computed/metrics/lantern-interactive.d.ts +3 -7
  188. package/core/computed/metrics/lantern-interactive.js +3 -5
  189. package/core/computed/metrics/lantern-largest-contentful-paint.d.ts +3 -7
  190. package/core/computed/metrics/lantern-largest-contentful-paint.js +3 -5
  191. package/core/computed/metrics/lantern-max-potential-fid.d.ts +3 -7
  192. package/core/computed/metrics/lantern-max-potential-fid.js +3 -5
  193. package/core/computed/metrics/lantern-metric.d.ts +8 -8
  194. package/core/computed/metrics/lantern-metric.js +1 -1
  195. package/core/computed/metrics/lantern-speed-index.d.ts +3 -7
  196. package/core/computed/metrics/lantern-speed-index.js +3 -5
  197. package/core/computed/metrics/lantern-total-blocking-time.d.ts +3 -7
  198. package/core/computed/metrics/lantern-total-blocking-time.js +1 -3
  199. package/core/computed/metrics/largest-contentful-paint-all-frames.d.ts +1 -3
  200. package/core/computed/metrics/largest-contentful-paint.d.ts +1 -3
  201. package/core/computed/metrics/lcp-breakdown.d.ts +3 -9
  202. package/core/computed/metrics/max-potential-fid.d.ts +1 -3
  203. package/core/computed/metrics/responsiveness.d.ts +7 -10
  204. package/core/computed/metrics/speed-index.d.ts +1 -3
  205. package/core/computed/metrics/time-to-first-byte.d.ts +1 -3
  206. package/core/computed/metrics/timing-summary.d.ts +8 -13
  207. package/core/computed/metrics/total-blocking-time.d.ts +1 -3
  208. package/core/computed/metrics/total-blocking-time.js +1 -1
  209. package/core/computed/module-duplication.d.ts +2 -8
  210. package/core/computed/navigation-insights.d.ts +2 -4
  211. package/core/computed/network-analysis.d.ts +2 -4
  212. package/core/computed/network-analysis.js +1 -1
  213. package/core/computed/network-records.d.ts +1 -3
  214. package/core/computed/page-dependency-graph.d.ts +9 -14
  215. package/core/computed/page-dependency-graph.js +3 -4
  216. package/core/computed/processed-navigation.d.ts +2 -5
  217. package/core/computed/processed-trace.d.ts +1 -3
  218. package/core/computed/resource-summary.d.ts +6 -10
  219. package/core/computed/screenshots.d.ts +1 -6
  220. package/core/computed/speedline.d.ts +1 -3
  221. package/core/computed/tbt-impact-tasks.d.ts +4 -5
  222. package/core/computed/tbt-impact-tasks.js +31 -8
  223. package/core/computed/trace-engine-result.d.ts +1 -3
  224. package/core/computed/trace-engine-result.js +10 -1
  225. package/core/computed/unused-css.d.ts +7 -9
  226. package/core/computed/unused-javascript-summary.d.ts +3 -5
  227. package/core/computed/user-timings.d.ts +3 -5
  228. package/core/computed/viewport-meta.d.ts +7 -9
  229. package/core/config/config-helpers.d.ts +5 -5
  230. package/core/config/config.d.ts +3 -3
  231. package/core/config/constants.d.ts +6 -6
  232. package/core/config/filters.d.ts +8 -8
  233. package/core/config/validation.d.ts +1 -1
  234. package/core/gather/driver/environment.d.ts +5 -5
  235. package/core/gather/driver/environment.js +1 -1
  236. package/core/gather/driver/execution-context.d.ts +6 -6
  237. package/core/gather/driver/navigation.d.ts +3 -3
  238. package/core/gather/driver/network-monitor.d.ts +6 -6
  239. package/core/gather/driver/storage.d.ts +4 -4
  240. package/core/gather/driver/target-manager.d.ts +4 -5
  241. package/core/gather/driver/target-manager.js +1 -1
  242. package/core/gather/driver/wait-for-condition.d.ts +3 -3
  243. package/core/gather/driver/wait-for-condition.js +4 -4
  244. package/core/gather/driver.d.ts +1 -1
  245. package/core/gather/gatherers/accessibility.d.ts +1 -1
  246. package/core/gather/gatherers/anchor-elements.d.ts +1 -1
  247. package/core/gather/gatherers/bf-cache-failures.d.ts +3 -3
  248. package/core/gather/gatherers/cache-contents.d.ts +1 -1
  249. package/core/gather/gatherers/console-messages.d.ts +1 -1
  250. package/core/gather/gatherers/css-usage.d.ts +1 -1
  251. package/core/gather/gatherers/devtools-log-compat.d.ts +3 -3
  252. package/core/gather/gatherers/devtools-log.d.ts +3 -3
  253. package/core/gather/gatherers/dobetterweb/doctype.d.ts +1 -1
  254. package/core/gather/gatherers/dobetterweb/domstats.d.ts +1 -1
  255. package/core/gather/gatherers/dobetterweb/optimized-images.d.ts +6 -7
  256. package/core/gather/gatherers/dobetterweb/response-compression.d.ts +4 -5
  257. package/core/gather/gatherers/full-page-screenshot.d.ts +3 -3
  258. package/core/gather/gatherers/iframe-elements.d.ts +1 -1
  259. package/core/gather/gatherers/image-elements.d.ts +1 -1
  260. package/core/gather/gatherers/inputs.d.ts +1 -1
  261. package/core/gather/gatherers/inspector-issues.d.ts +2 -2
  262. package/core/gather/gatherers/js-usage.d.ts +1 -1
  263. package/core/gather/gatherers/link-elements.d.ts +6 -10
  264. package/core/gather/gatherers/link-elements.js +5 -12
  265. package/core/gather/gatherers/main-document-content.d.ts +2 -2
  266. package/core/gather/gatherers/meta-elements.d.ts +1 -1
  267. package/core/gather/gatherers/network-user-agent.d.ts +4 -4
  268. package/core/gather/gatherers/root-causes.d.ts +3 -4
  269. package/core/gather/gatherers/seo/font-size.d.ts +19 -19
  270. package/core/gather/gatherers/seo/robots-txt.d.ts +1 -1
  271. package/core/gather/gatherers/source-maps.d.ts +2 -2
  272. package/core/gather/gatherers/stacks.d.ts +2 -2
  273. package/core/gather/gatherers/stylesheets.d.ts +1 -9
  274. package/core/gather/gatherers/stylesheets.js +8 -39
  275. package/core/gather/gatherers/trace-compat.d.ts +3 -3
  276. package/core/gather/gatherers/trace-elements.d.ts +4 -6
  277. package/core/gather/navigation-runner.d.ts +3 -4
  278. package/core/gather/runner-helpers.d.ts +3 -3
  279. package/core/gather/session.d.ts +4 -4
  280. package/core/gather/session.js +1 -1
  281. package/core/gather/snapshot-runner.d.ts +2 -2
  282. package/core/gather/timespan-runner.d.ts +3 -3
  283. package/core/index.d.cts +1 -7
  284. package/core/index.d.ts +6 -6
  285. package/core/lib/arbitrary-equality-map.d.ts +2 -2
  286. package/core/lib/asset-saver.d.ts +3 -3
  287. package/core/lib/asset-saver.js +1 -1
  288. package/core/lib/bf-cache-strings.d.ts +117 -117
  289. package/core/lib/cdt/Platform.d.ts +1 -1
  290. package/core/lib/cdt/SDK.d.ts +1 -1
  291. package/core/lib/cdt/generated/ParsedURL.js +2 -2
  292. package/core/lib/cdt/generated/SourceMap.d.ts +11 -11
  293. package/core/lib/cdt/generated/SourceMap.js +3 -3
  294. package/core/lib/csp-evaluator.d.ts +20 -20
  295. package/core/lib/deprecation-description.d.ts +3 -3
  296. package/core/lib/deprecations-strings.d.ts +112 -112
  297. package/core/lib/i18n/i18n.d.ts +48 -48
  298. package/core/lib/icons.d.ts +3 -3
  299. package/core/lib/lantern/lantern.d.ts +2 -19
  300. package/core/lib/lantern/lantern.js +2 -45
  301. package/core/lib/lantern-trace-saver.d.ts +5 -7
  302. package/core/lib/lantern-trace-saver.js +2 -3
  303. package/core/lib/lh-error.d.ts +87 -87
  304. package/core/lib/lighthouse-compatibility.d.ts +1 -1
  305. package/core/lib/manifest-parser.d.ts +1 -1
  306. package/core/lib/minify-devtoolslog.d.ts +1 -1
  307. package/core/lib/navigation-error.d.ts +4 -6
  308. package/core/lib/navigation-error.js +2 -2
  309. package/core/lib/network-recorder.js +1 -1
  310. package/core/lib/network-request.d.ts +5 -5
  311. package/core/lib/network-request.js +2 -2
  312. package/core/lib/page-functions.d.ts +2 -2
  313. package/core/lib/script-helpers.d.ts +0 -1
  314. package/core/lib/sentry.d.ts +8 -8
  315. package/core/lib/stack-packs.d.ts +1 -1
  316. package/core/lib/trace-engine.d.ts +2 -2
  317. package/core/lib/tracehouse/cpu-profile-model.d.ts +8 -8
  318. package/core/lib/tracehouse/cpu-profile-model.js +2 -2
  319. package/core/lib/tracehouse/main-thread-tasks.d.ts +5 -5
  320. package/core/lib/tracehouse/task-groups.d.ts +6 -38
  321. package/core/lib/tracehouse/task-summary.d.ts +0 -1
  322. package/core/lib/tracehouse/trace-processor.d.ts +9 -9
  323. package/core/lib/traces/metric-trace-events.d.ts +1 -1
  324. package/core/lib/url-utils.d.ts +4 -4
  325. package/core/runner.d.ts +3 -4
  326. package/core/runner.js +0 -1
  327. package/core/scoring.d.ts +0 -1
  328. package/core/user-flow.d.ts +5 -5
  329. package/dist/report/bundle.esm.js +1 -1
  330. package/dist/report/flow.js +1 -1
  331. package/dist/report/standalone.js +1 -1
  332. package/eslint-local-rules.d.cts +4 -1
  333. package/flow-report/src/i18n/localized-strings.d.ts +1 -1
  334. package/flow-report/src/i18n/ui-strings.d.ts +43 -43
  335. package/package.json +7 -7
  336. package/readme.md +0 -2
  337. package/report/generator/file-namer.d.ts +2 -2
  338. package/report/generator/flow-report-assets.d.ts +1 -1
  339. package/report/generator/report-generator.d.ts +4 -4
  340. package/report/renderer/api.d.ts +2 -5
  341. package/report/renderer/category-renderer.d.ts +8 -8
  342. package/report/renderer/components.d.ts +2 -2
  343. package/report/renderer/crc-details-renderer.d.ts +2 -2
  344. package/report/renderer/details-renderer.d.ts +7 -7
  345. package/report/renderer/dom.d.ts +7 -7
  346. package/report/renderer/drop-down-menu.d.ts +1 -1
  347. package/report/renderer/drop-down-menu.js +15 -17
  348. package/report/renderer/element-screenshot-renderer.d.ts +3 -3
  349. package/report/renderer/explodey-gauge.d.ts +2 -2
  350. package/report/renderer/features-util.d.ts +1 -1
  351. package/report/renderer/performance-category-renderer.d.ts +1 -1
  352. package/report/renderer/report-globals.d.ts +1 -1
  353. package/report/renderer/report-renderer.d.ts +1 -1
  354. package/report/renderer/report-ui-features.d.ts +1 -1
  355. package/report/renderer/report-utils.d.ts +62 -62
  356. package/report/renderer/snippet-renderer.d.ts +9 -9
  357. package/report/renderer/swap-locale-feature.d.ts +2 -2
  358. package/report/renderer/topbar-features.d.ts +2 -2
  359. package/report/types/augment-dom.d.ts +0 -11
  360. package/shared/localization/format.d.ts +3 -3
  361. package/shared/localization/locales/en-US.json +1 -1
  362. package/shared/localization/locales/en-XL.json +1 -1
  363. package/shared/localization/locales.d.ts +1 -1
  364. package/shared/type-verifiers.d.ts +1 -1
  365. package/shared/util.d.ts +6 -6
  366. package/tsconfig.json +1 -11
  367. package/types/artifacts.d.ts +4 -4
  368. package/types/gatherer.d.ts +4 -5
  369. package/types/internal/node.d.ts +0 -6
  370. package/types/internal/query-selector.d.ts +2 -2
  371. package/core/lib/lantern/BaseNode.d.ts +0 -163
  372. package/core/lib/lantern/BaseNode.js +0 -369
  373. package/core/lib/lantern/BaseNode.test.js +0 -385
  374. package/core/lib/lantern/CpuNode.d.ts +0 -43
  375. package/core/lib/lantern/CpuNode.js +0 -99
  376. package/core/lib/lantern/LanternError.d.ts +0 -8
  377. package/core/lib/lantern/LanternError.js +0 -9
  378. package/core/lib/lantern/Metric.d.ts +0 -69
  379. package/core/lib/lantern/Metric.js +0 -137
  380. package/core/lib/lantern/NetworkNode.d.ts +0 -49
  381. package/core/lib/lantern/NetworkNode.js +0 -136
  382. package/core/lib/lantern/PageDependencyGraph.d.ts +0 -82
  383. package/core/lib/lantern/PageDependencyGraph.js +0 -610
  384. package/core/lib/lantern/PageDependencyGraph.test.js +0 -654
  385. package/core/lib/lantern/TBTUtils.d.ts +0 -44
  386. package/core/lib/lantern/TBTUtils.js +0 -76
  387. package/core/lib/lantern/TBTUtils.test.d.ts +0 -2
  388. package/core/lib/lantern/TBTUtils.test.js +0 -130
  389. package/core/lib/lantern/TraceEngineComputationData.d.ts +0 -25
  390. package/core/lib/lantern/TraceEngineComputationData.js +0 -466
  391. package/core/lib/lantern/metrics/FirstContentfulPaint.d.ts +0 -79
  392. package/core/lib/lantern/metrics/FirstContentfulPaint.js +0 -198
  393. package/core/lib/lantern/metrics/FirstContentfulPaint.test.js +0 -54
  394. package/core/lib/lantern/metrics/Interactive.d.ts +0 -20
  395. package/core/lib/lantern/metrics/Interactive.js +0 -109
  396. package/core/lib/lantern/metrics/Interactive.test.js +0 -56
  397. package/core/lib/lantern/metrics/LargestContentfulPaint.d.ts +0 -19
  398. package/core/lib/lantern/metrics/LargestContentfulPaint.js +0 -105
  399. package/core/lib/lantern/metrics/LargestContentfulPaint.test.js +0 -42
  400. package/core/lib/lantern/metrics/MaxPotentialFID.d.ts +0 -24
  401. package/core/lib/lantern/metrics/MaxPotentialFID.js +0 -91
  402. package/core/lib/lantern/metrics/MetricTestUtils.d.ts +0 -19
  403. package/core/lib/lantern/metrics/MetricTestUtils.js +0 -48
  404. package/core/lib/lantern/metrics/SpeedIndex.d.ts +0 -32
  405. package/core/lib/lantern/metrics/SpeedIndex.js +0 -142
  406. package/core/lib/lantern/metrics/SpeedIndex.test.js +0 -83
  407. package/core/lib/lantern/metrics/TotalBlockingTime.d.ts +0 -25
  408. package/core/lib/lantern/metrics/TotalBlockingTime.js +0 -125
  409. package/core/lib/lantern/metrics/__snapshots__/FirstContentfulPaint.test.js.snap +0 -11
  410. package/core/lib/lantern/metrics/__snapshots__/Interactive.test.js.snap +0 -17
  411. package/core/lib/lantern/metrics/metrics.d.ts +0 -9
  412. package/core/lib/lantern/metrics/metrics.js +0 -16
  413. package/core/lib/lantern/simulation/ConnectionPool.d.ts +0 -48
  414. package/core/lib/lantern/simulation/ConnectionPool.js +0 -152
  415. package/core/lib/lantern/simulation/ConnectionPool.test.js +0 -195
  416. package/core/lib/lantern/simulation/Constants.d.ts +0 -52
  417. package/core/lib/lantern/simulation/Constants.js +0 -48
  418. package/core/lib/lantern/simulation/DNSCache.d.ts +0 -42
  419. package/core/lib/lantern/simulation/DNSCache.js +0 -74
  420. package/core/lib/lantern/simulation/DNSCache.test.js +0 -72
  421. package/core/lib/lantern/simulation/NetworkAnalyzer.d.ts +0 -209
  422. package/core/lib/lantern/simulation/NetworkAnalyzer.js +0 -597
  423. package/core/lib/lantern/simulation/NetworkAnalyzer.test.js +0 -475
  424. package/core/lib/lantern/simulation/SimulationTimingMap.d.ts +0 -153
  425. package/core/lib/lantern/simulation/SimulationTimingMap.js +0 -219
  426. package/core/lib/lantern/simulation/Simulator.d.ts +0 -157
  427. package/core/lib/lantern/simulation/Simulator.js +0 -593
  428. package/core/lib/lantern/simulation/Simulator.test.js +0 -434
  429. package/core/lib/lantern/simulation/TCPConnection.test.d.ts +0 -2
  430. package/core/lib/lantern/simulation/TCPConnection.test.js +0 -374
  431. package/core/lib/lantern/simulation/TcpConnection.d.ts +0 -89
  432. package/core/lib/lantern/simulation/TcpConnection.js +0 -230
  433. package/core/lib/lantern/simulation/simulation.d.ts +0 -21
  434. package/core/lib/lantern/simulation/simulation.js +0 -28
  435. package/core/lib/lantern/types/lantern.d.ts +0 -256
  436. package/core/lib/lantern/types/lantern.js +0 -7
@@ -1,610 +0,0 @@
1
- /**
2
- * @license
3
- * Copyright 2024 Google LLC
4
- * SPDX-License-Identifier: Apache-2.0
5
- */
6
-
7
- import * as Lantern from './lantern.js';
8
- import {NetworkNode} from './NetworkNode.js';
9
- import {CPUNode} from './CpuNode.js';
10
-
11
- // COMPAT: m71+ We added RunTask to `disabled-by-default-lighthouse`
12
- const SCHEDULABLE_TASK_TITLE_LH = 'RunTask';
13
- // m69-70 DoWork is different and we now need RunTask, see https://bugs.chromium.org/p/chromium/issues/detail?id=871204#c11
14
- const SCHEDULABLE_TASK_TITLE_ALT1 = 'ThreadControllerImpl::RunTask';
15
- // In m66-68 refactored to this task title, https://crrev.com/c/883346
16
- const SCHEDULABLE_TASK_TITLE_ALT2 = 'ThreadControllerImpl::DoWork';
17
- // m65 and earlier
18
- const SCHEDULABLE_TASK_TITLE_ALT3 = 'TaskQueueManager::ProcessTaskFromWorkQueue';
19
-
20
- /** @typedef {import('./BaseNode.js').Node} Node */
21
-
22
- /**
23
- * @typedef {Object} NetworkNodeOutput
24
- * @property {Array<NetworkNode>} nodes
25
- * @property {Map<string, NetworkNode>} idToNodeMap
26
- * @property {Map<string, Array<NetworkNode>>} urlToNodeMap
27
- * @property {Map<string, NetworkNode|null>} frameIdToNodeMap
28
- */
29
-
30
- // Shorter tasks have negligible impact on simulation results.
31
- const SIGNIFICANT_DUR_THRESHOLD_MS = 10;
32
-
33
- // TODO: video files tend to be enormous and throw off all graph traversals, move this ignore
34
- // into estimation logic when we use the dependency graph for other purposes.
35
- const IGNORED_MIME_TYPES_REGEX = /^video/;
36
-
37
- class PageDependencyGraph {
38
- /**
39
- * @param {Lantern.NetworkRequest} request
40
- * @return {Array<string>}
41
- */
42
- static getNetworkInitiators(request) {
43
- if (!request.initiator) return [];
44
- if (request.initiator.url) return [request.initiator.url];
45
- if (request.initiator.type === 'script') {
46
- // Script initiators have the stack of callFrames from all functions that led to this request.
47
- // If async stacks are enabled, then the stack will also have the parent functions that asynchronously
48
- // led to this request chained in the `parent` property.
49
- /** @type {Set<string>} */
50
- const scriptURLs = new Set();
51
- let stack = request.initiator.stack;
52
- while (stack) {
53
- const callFrames = stack.callFrames || [];
54
- for (const frame of callFrames) {
55
- if (frame.url) scriptURLs.add(frame.url);
56
- }
57
-
58
- stack = stack.parent;
59
- }
60
-
61
- return Array.from(scriptURLs);
62
- }
63
-
64
- return [];
65
- }
66
-
67
- /**
68
- * @param {Array<Lantern.NetworkRequest>} networkRequests
69
- * @return {NetworkNodeOutput}
70
- */
71
- static getNetworkNodeOutput(networkRequests) {
72
- /** @type {Array<NetworkNode>} */
73
- const nodes = [];
74
- /** @type {Map<string, NetworkNode>} */
75
- const idToNodeMap = new Map();
76
- /** @type {Map<string, Array<NetworkNode>>} */
77
- const urlToNodeMap = new Map();
78
- /** @type {Map<string, NetworkNode|null>} */
79
- const frameIdToNodeMap = new Map();
80
-
81
- networkRequests.forEach(request => {
82
- if (IGNORED_MIME_TYPES_REGEX.test(request.mimeType)) return;
83
- if (request.fromWorker) return;
84
-
85
- // Network requestIds can be duplicated for an unknown reason
86
- // Suffix all subsequent requests with `:duplicate` until it's unique
87
- // NOTE: This should never happen with modern NetworkRequest library, but old fixtures
88
- // might still have this issue.
89
- while (idToNodeMap.has(request.requestId)) {
90
- request.requestId += ':duplicate';
91
- }
92
-
93
- const node = new NetworkNode(request);
94
- nodes.push(node);
95
-
96
- const urlList = urlToNodeMap.get(request.url) || [];
97
- urlList.push(node);
98
-
99
- idToNodeMap.set(request.requestId, node);
100
- urlToNodeMap.set(request.url, urlList);
101
-
102
- // If the request was for the root document of an iframe, save an entry in our
103
- // map so we can link up the task `args.data.frame` dependencies later in graph creation.
104
- if (request.frameId &&
105
- request.resourceType === Lantern.NetworkRequestTypes.Document &&
106
- request.documentURL === request.url) {
107
- // If there's ever any ambiguity, permanently set the value to `false` to avoid loops in the graph.
108
- const value = frameIdToNodeMap.has(request.frameId) ? null : node;
109
- frameIdToNodeMap.set(request.frameId, value);
110
- }
111
- });
112
-
113
- return {nodes, idToNodeMap, urlToNodeMap, frameIdToNodeMap};
114
- }
115
-
116
- /**
117
- * @param {Lantern.TraceEvent} evt
118
- * @return {boolean}
119
- */
120
- static isScheduleableTask(evt) {
121
- return evt.name === SCHEDULABLE_TASK_TITLE_LH ||
122
- evt.name === SCHEDULABLE_TASK_TITLE_ALT1 ||
123
- evt.name === SCHEDULABLE_TASK_TITLE_ALT2 ||
124
- evt.name === SCHEDULABLE_TASK_TITLE_ALT3;
125
- }
126
-
127
- /**
128
- * There should *always* be at least one top level event, having 0 typically means something is
129
- * drastically wrong with the trace and we should just give up early and loudly.
130
- *
131
- * @param {Lantern.TraceEvent[]} events
132
- */
133
- static assertHasToplevelEvents(events) {
134
- const hasToplevelTask = events.some(this.isScheduleableTask);
135
- if (!hasToplevelTask) {
136
- throw new Error('Could not find any top level events');
137
- }
138
- }
139
-
140
- /**
141
- * @param {Lantern.TraceEvent[]} mainThreadEvents
142
- * @return {Array<CPUNode>}
143
- */
144
- static getCPUNodes(mainThreadEvents) {
145
- /** @type {Array<CPUNode>} */
146
- const nodes = [];
147
- let i = 0;
148
-
149
- PageDependencyGraph.assertHasToplevelEvents(mainThreadEvents);
150
-
151
- while (i < mainThreadEvents.length) {
152
- const evt = mainThreadEvents[i];
153
- i++;
154
-
155
- // Skip all trace events that aren't schedulable tasks with sizable duration
156
- if (!PageDependencyGraph.isScheduleableTask(evt) || !evt.dur) {
157
- continue;
158
- }
159
-
160
- /** @type {number|undefined} */
161
- let correctedEndTs = undefined;
162
-
163
- // Capture all events that occurred within the task
164
- /** @type {Array<Lantern.TraceEvent>} */
165
- const children = [];
166
- for (
167
- const endTime = evt.ts + evt.dur;
168
- i < mainThreadEvents.length && mainThreadEvents[i].ts < endTime;
169
- i++
170
- ) {
171
- const event = mainThreadEvents[i];
172
-
173
- // Temporary fix for a Chrome bug where some RunTask events can be overlapping.
174
- // We correct that here be ensuring each RunTask ends at least 1 microsecond before the next
175
- // https://github.com/GoogleChrome/lighthouse/issues/15896
176
- // https://issues.chromium.org/issues/329678173
177
- if (PageDependencyGraph.isScheduleableTask(event) && event.dur) {
178
- correctedEndTs = event.ts - 1;
179
- break;
180
- }
181
-
182
- children.push(event);
183
- }
184
-
185
- nodes.push(new CPUNode(evt, children, correctedEndTs));
186
- }
187
-
188
- return nodes;
189
- }
190
-
191
- /**
192
- * @param {NetworkNode} rootNode
193
- * @param {NetworkNodeOutput} networkNodeOutput
194
- */
195
- static linkNetworkNodes(rootNode, networkNodeOutput) {
196
- networkNodeOutput.nodes.forEach(node => {
197
- const directInitiatorRequest = node.request.initiatorRequest || rootNode.request;
198
- const directInitiatorNode =
199
- networkNodeOutput.idToNodeMap.get(directInitiatorRequest.requestId) || rootNode;
200
- const canDependOnInitiator =
201
- !directInitiatorNode.isDependentOn(node) &&
202
- node.canDependOn(directInitiatorNode);
203
- const initiators = PageDependencyGraph.getNetworkInitiators(node.request);
204
- if (initiators.length) {
205
- initiators.forEach(initiator => {
206
- const parentCandidates = networkNodeOutput.urlToNodeMap.get(initiator) || [];
207
- // Only add the edge if the parent is unambiguous with valid timing and isn't circular.
208
- if (parentCandidates.length === 1 &&
209
- parentCandidates[0].startTime <= node.startTime &&
210
- !parentCandidates[0].isDependentOn(node)) {
211
- node.addDependency(parentCandidates[0]);
212
- } else if (canDependOnInitiator) {
213
- directInitiatorNode.addDependent(node);
214
- }
215
- });
216
- } else if (canDependOnInitiator) {
217
- directInitiatorNode.addDependent(node);
218
- }
219
-
220
- // Make sure the nodes are attached to the graph if the initiator information was invalid.
221
- if (node !== rootNode && node.getDependencies().length === 0 && node.canDependOn(rootNode)) {
222
- node.addDependency(rootNode);
223
- }
224
-
225
- if (!node.request.redirects) return;
226
-
227
- const redirects = [...node.request.redirects, node.request];
228
- for (let i = 1; i < redirects.length; i++) {
229
- const redirectNode = networkNodeOutput.idToNodeMap.get(redirects[i - 1].requestId);
230
- const actualNode = networkNodeOutput.idToNodeMap.get(redirects[i].requestId);
231
- if (actualNode && redirectNode) {
232
- actualNode.addDependency(redirectNode);
233
- }
234
- }
235
- });
236
- }
237
-
238
- /**
239
- * @param {Node} rootNode
240
- * @param {NetworkNodeOutput} networkNodeOutput
241
- * @param {Array<CPUNode>} cpuNodes
242
- */
243
- static linkCPUNodes(rootNode, networkNodeOutput, cpuNodes) {
244
- /** @type {Set<Lantern.ResourceType|undefined>} */
245
- const linkableResourceTypes = new Set([
246
- Lantern.NetworkRequestTypes.XHR,
247
- Lantern.NetworkRequestTypes.Fetch,
248
- Lantern.NetworkRequestTypes.Script,
249
- ]);
250
-
251
- /** @param {CPUNode} cpuNode @param {string} reqId */
252
- function addDependentNetworkRequest(cpuNode, reqId) {
253
- const networkNode = networkNodeOutput.idToNodeMap.get(reqId);
254
- if (!networkNode ||
255
- // Ignore all network nodes that started before this CPU task started
256
- // A network request that started earlier could not possibly have been started by this task
257
- networkNode.startTime <= cpuNode.startTime) return;
258
- const {request} = networkNode;
259
- const resourceType = request.resourceType ||
260
- request.redirectDestination?.resourceType;
261
- if (!linkableResourceTypes.has(resourceType)) {
262
- // We only link some resources to CPU nodes because we observe LCP simulation
263
- // regressions when including images, etc.
264
- return;
265
- }
266
- cpuNode.addDependent(networkNode);
267
- }
268
-
269
- /**
270
- * If the node has an associated frameId, then create a dependency on the root document request
271
- * for the frame. The task obviously couldn't have started before the frame was even downloaded.
272
- *
273
- * @param {CPUNode} cpuNode
274
- * @param {string|undefined} frameId
275
- */
276
- function addDependencyOnFrame(cpuNode, frameId) {
277
- if (!frameId) return;
278
- const networkNode = networkNodeOutput.frameIdToNodeMap.get(frameId);
279
- if (!networkNode) return;
280
- // Ignore all network nodes that started after this CPU task started
281
- // A network request that started after could not possibly be required this task
282
- if (networkNode.startTime >= cpuNode.startTime) return;
283
- cpuNode.addDependency(networkNode);
284
- }
285
-
286
- /** @param {CPUNode} cpuNode @param {string} url */
287
- function addDependencyOnUrl(cpuNode, url) {
288
- if (!url) return;
289
- // Allow network requests that end up to 100ms before the task started
290
- // Some script evaluations can start before the script finishes downloading
291
- const minimumAllowableTimeSinceNetworkNodeEnd = -100 * 1000;
292
- const candidates = networkNodeOutput.urlToNodeMap.get(url) || [];
293
-
294
- let minCandidate = null;
295
- let minDistance = Infinity;
296
- // Find the closest request that finished before this CPU task started
297
- for (const candidate of candidates) {
298
- // Explicitly ignore all requests that started after this CPU node
299
- // A network request that started after this task started cannot possibly be a dependency
300
- if (cpuNode.startTime <= candidate.startTime) return;
301
-
302
- const distance = cpuNode.startTime - candidate.endTime;
303
- if (distance >= minimumAllowableTimeSinceNetworkNodeEnd && distance < minDistance) {
304
- minCandidate = candidate;
305
- minDistance = distance;
306
- }
307
- }
308
-
309
- if (!minCandidate) return;
310
- cpuNode.addDependency(minCandidate);
311
- }
312
-
313
- /** @type {Map<string, CPUNode>} */
314
- const timers = new Map();
315
- for (const node of cpuNodes) {
316
- for (const evt of node.childEvents) {
317
- if (!evt.args.data) continue;
318
-
319
- const argsUrl = evt.args.data.url;
320
- const stackTraceUrls = (evt.args.data.stackTrace || []).map(l => l.url).filter(Boolean);
321
-
322
- switch (evt.name) {
323
- case 'TimerInstall':
324
- // @ts-expect-error - 'TimerInstall' event means timerId exists.
325
- timers.set(evt.args.data.timerId, node);
326
- stackTraceUrls.forEach(url => addDependencyOnUrl(node, url));
327
- break;
328
- case 'TimerFire': {
329
- // @ts-expect-error - 'TimerFire' event means timerId exists.
330
- const installer = timers.get(evt.args.data.timerId);
331
- if (!installer || installer.endTime > node.startTime) break;
332
- installer.addDependent(node);
333
- break;
334
- }
335
-
336
- case 'InvalidateLayout':
337
- case 'ScheduleStyleRecalculation':
338
- addDependencyOnFrame(node, evt.args.data.frame);
339
- stackTraceUrls.forEach(url => addDependencyOnUrl(node, url));
340
- break;
341
-
342
- case 'EvaluateScript':
343
- addDependencyOnFrame(node, evt.args.data.frame);
344
- // @ts-expect-error - 'EvaluateScript' event means argsUrl is defined.
345
- addDependencyOnUrl(node, argsUrl);
346
- stackTraceUrls.forEach(url => addDependencyOnUrl(node, url));
347
- break;
348
-
349
- case 'XHRReadyStateChange':
350
- // Only create the dependency if the request was completed
351
- // 'XHRReadyStateChange' event means readyState is defined.
352
- if (evt.args.data.readyState !== 4) break;
353
-
354
- // @ts-expect-error - 'XHRReadyStateChange' event means argsUrl is defined.
355
- addDependencyOnUrl(node, argsUrl);
356
- stackTraceUrls.forEach(url => addDependencyOnUrl(node, url));
357
- break;
358
-
359
- case 'FunctionCall':
360
- case 'v8.compile':
361
- addDependencyOnFrame(node, evt.args.data.frame);
362
- // @ts-expect-error - events mean argsUrl is defined.
363
- addDependencyOnUrl(node, argsUrl);
364
- break;
365
-
366
- case 'ParseAuthorStyleSheet':
367
- addDependencyOnFrame(node, evt.args.data.frame);
368
- // @ts-expect-error - 'ParseAuthorStyleSheet' event means styleSheetUrl is defined.
369
- addDependencyOnUrl(node, evt.args.data.styleSheetUrl);
370
- break;
371
-
372
- case 'ResourceSendRequest':
373
- addDependencyOnFrame(node, evt.args.data.frame);
374
- // @ts-expect-error - 'ResourceSendRequest' event means requestId is defined.
375
- addDependentNetworkRequest(node, evt.args.data.requestId);
376
- stackTraceUrls.forEach(url => addDependencyOnUrl(node, url));
377
- break;
378
- }
379
- }
380
-
381
- // Nodes starting before the root node cannot depend on it.
382
- if (node.getNumberOfDependencies() === 0 && node.canDependOn(rootNode)) {
383
- node.addDependency(rootNode);
384
- }
385
- }
386
-
387
- // Second pass to prune the graph of short tasks.
388
- const minimumEvtDur = SIGNIFICANT_DUR_THRESHOLD_MS * 1000;
389
- let foundFirstLayout = false;
390
- let foundFirstPaint = false;
391
- let foundFirstParse = false;
392
-
393
- for (const node of cpuNodes) {
394
- // Don't prune if event is the first ParseHTML/Layout/Paint.
395
- // See https://github.com/GoogleChrome/lighthouse/issues/9627#issuecomment-526699524 for more.
396
- let isFirst = false;
397
- if (!foundFirstLayout && node.childEvents.some(evt => evt.name === 'Layout')) {
398
- isFirst = foundFirstLayout = true;
399
- }
400
- if (!foundFirstPaint && node.childEvents.some(evt => evt.name === 'Paint')) {
401
- isFirst = foundFirstPaint = true;
402
- }
403
- if (!foundFirstParse && node.childEvents.some(evt => evt.name === 'ParseHTML')) {
404
- isFirst = foundFirstParse = true;
405
- }
406
-
407
- if (isFirst || node.duration >= minimumEvtDur) {
408
- // Don't prune this node. The task is long / important so it will impact simulation.
409
- continue;
410
- }
411
-
412
- // Prune the node if it isn't highly connected to minimize graph size. Rewiring the graph
413
- // here replaces O(M + N) edges with (M * N) edges, which is fine if either M or N is at
414
- // most 1.
415
- if (node.getNumberOfDependencies() === 1 || node.getNumberOfDependents() <= 1) {
416
- PageDependencyGraph._pruneNode(node);
417
- }
418
- }
419
- }
420
-
421
- /**
422
- * Removes the given node from the graph, but retains all paths between its dependencies and
423
- * dependents.
424
- * @param {Node} node
425
- */
426
- static _pruneNode(node) {
427
- const dependencies = node.getDependencies();
428
- const dependents = node.getDependents();
429
- for (const dependency of dependencies) {
430
- node.removeDependency(dependency);
431
- for (const dependent of dependents) {
432
- dependency.addDependent(dependent);
433
- }
434
- }
435
- for (const dependent of dependents) {
436
- node.removeDependent(dependent);
437
- }
438
- }
439
-
440
- /**
441
- * TODO(15841): remove when CDT backend is gone. until then, this is a useful debugging tool
442
- * to find delta between using CDP or the trace to create the network requests.
443
- *
444
- * When a test fails using the trace backend, I enabled this debug method and copied the network
445
- * requests when CDP was used, then when trace is used, and diff'd them. This method helped
446
- * remove non-logical differences from the comparison (order of properties, slight rounding
447
- * discrepancies, removing object cycles, etc).
448
- *
449
- * When using for a unit test, make sure to do `.only` so you are getting what you expect.
450
- * @param {Lantern.NetworkRequest[]} lanternRequests
451
- * @return {never}
452
- */
453
- static _debugNormalizeRequests(lanternRequests) {
454
- for (const request of lanternRequests) {
455
- request.rendererStartTime = Math.round(request.rendererStartTime * 1000) / 1000;
456
- request.networkRequestTime = Math.round(request.networkRequestTime * 1000) / 1000;
457
- request.responseHeadersEndTime = Math.round(request.responseHeadersEndTime * 1000) / 1000;
458
- request.networkEndTime = Math.round(request.networkEndTime * 1000) / 1000;
459
- }
460
-
461
- for (const r of lanternRequests) {
462
- delete r.rawRequest;
463
- if (r.initiatorRequest) {
464
- // @ts-expect-error
465
- r.initiatorRequest = {id: r.initiatorRequest.requestId};
466
- }
467
- if (r.redirectDestination) {
468
- // @ts-expect-error
469
- r.redirectDestination = {id: r.redirectDestination.requestId};
470
- }
471
- if (r.redirectSource) {
472
- // @ts-expect-error
473
- r.redirectSource = {id: r.redirectSource.requestId};
474
- }
475
- if (r.redirects) {
476
- // @ts-expect-error
477
- r.redirects = r.redirects.map(r2 => r2.requestId);
478
- }
479
- }
480
- /** @type {Lantern.NetworkRequest[]} */
481
- const requests = lanternRequests.map(r => ({
482
- requestId: r.requestId,
483
- connectionId: r.connectionId,
484
- connectionReused: r.connectionReused,
485
- url: r.url,
486
- protocol: r.protocol,
487
- parsedURL: r.parsedURL,
488
- documentURL: r.documentURL,
489
- rendererStartTime: r.rendererStartTime,
490
- networkRequestTime: r.networkRequestTime,
491
- responseHeadersEndTime: r.responseHeadersEndTime,
492
- networkEndTime: r.networkEndTime,
493
- transferSize: r.transferSize,
494
- resourceSize: r.resourceSize,
495
- fromDiskCache: r.fromDiskCache,
496
- fromMemoryCache: r.fromMemoryCache,
497
- finished: r.finished,
498
- statusCode: r.statusCode,
499
- redirectSource: r.redirectSource,
500
- redirectDestination: r.redirectDestination,
501
- redirects: r.redirects,
502
- failed: r.failed,
503
- initiator: r.initiator,
504
- timing: r.timing ? {
505
- requestTime: r.timing.requestTime,
506
- proxyStart: r.timing.proxyStart,
507
- proxyEnd: r.timing.proxyEnd,
508
- dnsStart: r.timing.dnsStart,
509
- dnsEnd: r.timing.dnsEnd,
510
- connectStart: r.timing.connectStart,
511
- connectEnd: r.timing.connectEnd,
512
- sslStart: r.timing.sslStart,
513
- sslEnd: r.timing.sslEnd,
514
- workerStart: r.timing.workerStart,
515
- workerReady: r.timing.workerReady,
516
- workerFetchStart: r.timing.workerFetchStart,
517
- workerRespondWithSettled: r.timing.workerRespondWithSettled,
518
- sendStart: r.timing.sendStart,
519
- sendEnd: r.timing.sendEnd,
520
- pushStart: r.timing.pushStart,
521
- pushEnd: r.timing.pushEnd,
522
- receiveHeadersStart: r.timing.receiveHeadersStart,
523
- receiveHeadersEnd: r.timing.receiveHeadersEnd,
524
- } : r.timing,
525
- resourceType: r.resourceType,
526
- mimeType: r.mimeType,
527
- priority: r.priority,
528
- initiatorRequest: r.initiatorRequest,
529
- frameId: r.frameId,
530
- fromWorker: r.fromWorker,
531
- isLinkPreload: r.isLinkPreload,
532
- serverResponseTime: r.serverResponseTime,
533
- })).filter(r => !r.fromWorker);
534
- // eslint-disable-next-line no-unused-vars
535
- const debug = requests;
536
- // Set breakpoint here.
537
- // Copy `debug` and compare with https://www.diffchecker.com/text-compare/
538
- process.exit(1);
539
- }
540
-
541
- /**
542
- * @param {Lantern.TraceEvent[]} mainThreadEvents
543
- * @param {Lantern.NetworkRequest[]} networkRequests
544
- * @param {Lantern.Simulation.URL} URL
545
- * @return {Node}
546
- */
547
- static createGraph(mainThreadEvents, networkRequests, URL) {
548
- // This is for debugging trace/devtoolslog network records.
549
- // const debug = PageDependencyGraph._debugNormalizeRequests(networkRequests);
550
- const networkNodeOutput = PageDependencyGraph.getNetworkNodeOutput(networkRequests);
551
- const cpuNodes = PageDependencyGraph.getCPUNodes(mainThreadEvents);
552
- const {requestedUrl, mainDocumentUrl} = URL;
553
- if (!requestedUrl) throw new Error('requestedUrl is required to get the root request');
554
- if (!mainDocumentUrl) throw new Error('mainDocumentUrl is required to get the main resource');
555
-
556
- const rootRequest =
557
- Lantern.Simulation.NetworkAnalyzer.findResourceForUrl(networkRequests, requestedUrl);
558
- if (!rootRequest) throw new Error('rootRequest not found');
559
- const rootNode = networkNodeOutput.idToNodeMap.get(rootRequest.requestId);
560
- if (!rootNode) throw new Error('rootNode not found');
561
- const mainDocumentRequest =
562
- Lantern.Simulation.NetworkAnalyzer.findLastDocumentForUrl(networkRequests, mainDocumentUrl);
563
- if (!mainDocumentRequest) throw new Error('mainDocumentRequest not found');
564
- const mainDocumentNode = networkNodeOutput.idToNodeMap.get(mainDocumentRequest.requestId);
565
- if (!mainDocumentNode) throw new Error('mainDocumentNode not found');
566
-
567
- PageDependencyGraph.linkNetworkNodes(rootNode, networkNodeOutput);
568
- PageDependencyGraph.linkCPUNodes(rootNode, networkNodeOutput, cpuNodes);
569
- mainDocumentNode.setIsMainDocument(true);
570
-
571
- if (NetworkNode.hasCycle(rootNode)) {
572
- throw new Error('Invalid dependency graph created, cycle detected');
573
- }
574
-
575
- return rootNode;
576
- }
577
-
578
- /**
579
- * @param {Node} rootNode
580
- */
581
- static printGraph(rootNode, widthInCharacters = 100) {
582
- /** @param {string} str @param {number} target */
583
- function padRight(str, target, padChar = ' ') {
584
- return str + padChar.repeat(Math.max(target - str.length, 0));
585
- }
586
-
587
- /** @type {Array<Node>} */
588
- const nodes = [];
589
- rootNode.traverse(node => nodes.push(node));
590
- nodes.sort((a, b) => a.startTime - b.startTime);
591
-
592
- const min = nodes[0].startTime;
593
- const max = nodes.reduce((max, node) => Math.max(max, node.endTime), 0);
594
-
595
- const totalTime = max - min;
596
- const timePerCharacter = totalTime / widthInCharacters;
597
- nodes.forEach(node => {
598
- const offset = Math.round((node.startTime - min) / timePerCharacter);
599
- const length = Math.ceil((node.endTime - node.startTime) / timePerCharacter);
600
- const bar = padRight('', offset) + padRight('', length, '=');
601
-
602
- // @ts-expect-error -- disambiguate displayName from across possible Node types.
603
- const displayName = node.request ? node.request.url : node.type;
604
- // eslint-disable-next-line
605
- console.log(padRight(bar, widthInCharacters), `| ${displayName.slice(0, 30)}`);
606
- });
607
- }
608
- }
609
-
610
- export {PageDependencyGraph};