@paulirish/trace_engine 0.0.67-beta.1 → 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 (776) 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.d.ts +8 -0
  14. package/core/common/ParsedURL.js +512 -0
  15. package/core/common/ParsedURL.js.map +1 -0
  16. package/core/common/common.d.ts +8 -33
  17. package/core/common/common.js +2 -0
  18. package/core/host/host.d.ts +1 -13
  19. package/core/host/host.js +1 -0
  20. package/core/i18n/i18n.d.ts +20 -8
  21. package/core/i18n/i18n.js +15 -0
  22. package/core/platform/ArrayUtilities.js +224 -0
  23. package/core/platform/ArrayUtilities.js.map +1 -0
  24. package/core/platform/Brand.js +5 -0
  25. package/core/platform/Brand.js.map +1 -0
  26. package/core/platform/Constructor.js +5 -0
  27. package/core/platform/Constructor.js.map +1 -0
  28. package/core/platform/DateUtilities.js +14 -0
  29. package/core/platform/DateUtilities.js.map +1 -0
  30. package/core/platform/DevToolsPath.js +28 -0
  31. package/core/platform/DevToolsPath.js.map +1 -0
  32. package/core/platform/HostRuntime.js +8 -0
  33. package/core/platform/HostRuntime.js.map +1 -0
  34. package/core/platform/KeyboardUtilities.js +34 -0
  35. package/core/platform/KeyboardUtilities.js.map +1 -0
  36. package/core/platform/MapUtilities.js +80 -0
  37. package/core/platform/MapUtilities.js.map +1 -0
  38. package/core/platform/MimeType.js +157 -0
  39. package/core/platform/MimeType.js.map +1 -0
  40. package/core/platform/NumberUtilities.js +73 -0
  41. package/core/platform/NumberUtilities.js.map +1 -0
  42. package/core/platform/Size.js +36 -0
  43. package/core/platform/Size.js.map +1 -0
  44. package/core/platform/StringUtilities.d.ts +21 -0
  45. package/core/platform/StringUtilities.js +731 -0
  46. package/core/platform/StringUtilities.js.map +1 -0
  47. package/core/platform/Timing.js +10 -0
  48. package/core/platform/Timing.js.map +1 -0
  49. package/core/platform/TypedArrayUtilities.js +158 -0
  50. package/core/platform/TypedArrayUtilities.js.map +1 -0
  51. package/core/platform/TypescriptUtilities.js +17 -0
  52. package/core/platform/TypescriptUtilities.js.map +1 -0
  53. package/core/platform/UIString.d.ts +5 -2
  54. package/core/platform/UIString.js +5 -0
  55. package/core/platform/UIString.js.map +1 -0
  56. package/core/platform/UserVisibleError.d.ts +1 -12
  57. package/core/platform/UserVisibleError.js +23 -0
  58. package/core/platform/UserVisibleError.js.map +1 -0
  59. package/core/platform/api/HostRuntime.d.ts +1 -0
  60. package/core/platform/api/HostRuntime.js +5 -0
  61. package/core/platform/api/HostRuntime.js.map +1 -0
  62. package/core/platform/api/api-tsconfig.json +58 -0
  63. package/core/platform/api/api-tsconfig.ref.json +26 -0
  64. package/core/platform/api/api.js +6 -0
  65. package/core/platform/api/api.js.map +1 -0
  66. package/core/platform/bundle-tsconfig.json +59 -0
  67. package/core/platform/bundle-tsconfig.ref.json +27 -0
  68. package/core/platform/foundation_unittests-tsconfig.json +73 -0
  69. package/core/platform/foundation_unittests-tsconfig.ref.json +40 -0
  70. package/core/platform/foundation_unittests_node_typecheck-tsconfig.json +69 -0
  71. package/core/platform/platform-tsconfig.json +81 -0
  72. package/core/platform/platform-tsconfig.ref.json +49 -0
  73. package/core/platform/platform.js +28 -0
  74. package/core/platform/platform.js.map +1 -0
  75. package/core/platform/platform_node_typecheck-tsconfig.json +78 -0
  76. package/core/platform/platform_node_typecheck.stamp +0 -0
  77. package/core/root/root.d.ts +1 -4
  78. package/core/root/root.js +1 -0
  79. package/core/sdk/sdk.d.ts +27 -97
  80. package/core/sdk/sdk.js +1 -0
  81. package/generated/protocol.d.ts +93 -30
  82. package/generated/protocol.js +3304 -0
  83. package/locales/af.json +173 -176
  84. package/locales/am.json +352 -355
  85. package/locales/ar.json +353 -356
  86. package/locales/as.json +351 -354
  87. package/locales/az.json +342 -345
  88. package/locales/be.json +352 -355
  89. package/locales/bg.json +352 -355
  90. package/locales/bn.json +352 -355
  91. package/locales/bs.json +254 -257
  92. package/locales/ca.json +284 -287
  93. package/locales/cs.json +337 -340
  94. package/locales/cy.json +147 -150
  95. package/locales/da.json +234 -237
  96. package/locales/de.json +253 -256
  97. package/locales/el.json +337 -340
  98. package/locales/en-GB.json +135 -138
  99. package/locales/en-US.json +300 -300
  100. package/locales/en-XL.json +1055 -0
  101. package/locales/es-419.json +283 -286
  102. package/locales/es.json +283 -286
  103. package/locales/et.json +239 -242
  104. package/locales/eu.json +134 -137
  105. package/locales/fa.json +352 -355
  106. package/locales/fi.json +284 -287
  107. package/locales/fil.json +131 -134
  108. package/locales/fr-CA.json +311 -314
  109. package/locales/fr.json +310 -313
  110. package/locales/gl.json +265 -268
  111. package/locales/gu.json +353 -356
  112. package/locales/he.json +353 -356
  113. package/locales/hi.json +337 -340
  114. package/locales/hr.json +258 -261
  115. package/locales/hu.json +343 -346
  116. package/locales/hy.json +352 -355
  117. package/locales/id.json +131 -134
  118. package/locales/is.json +305 -308
  119. package/locales/it.json +222 -225
  120. package/locales/ja.json +352 -355
  121. package/locales/ka.json +353 -356
  122. package/locales/kk.json +353 -356
  123. package/locales/km.json +352 -355
  124. package/locales/kn.json +353 -356
  125. package/locales/ko.json +352 -355
  126. package/locales/ky.json +351 -354
  127. package/locales/lo.json +353 -356
  128. package/locales/lt.json +324 -327
  129. package/locales/lv.json +318 -321
  130. package/locales/mk.json +353 -356
  131. package/locales/ml.json +352 -355
  132. package/locales/mn.json +352 -355
  133. package/locales/mr.json +352 -355
  134. package/locales/ms.json +131 -134
  135. package/locales/my.json +351 -354
  136. package/locales/ne.json +337 -340
  137. package/locales/nl.json +184 -187
  138. package/locales/no.json +240 -243
  139. package/locales/or.json +352 -355
  140. package/locales/pa.json +352 -355
  141. package/locales/pl.json +308 -311
  142. package/locales/pt-PT.json +275 -278
  143. package/locales/pt.json +271 -274
  144. package/locales/ro.json +310 -313
  145. package/locales/ru.json +352 -355
  146. package/locales/si.json +353 -356
  147. package/locales/sk.json +334 -337
  148. package/locales/sl.json +275 -278
  149. package/locales/sq.json +317 -320
  150. package/locales/sr-Latn.json +257 -260
  151. package/locales/sr.json +353 -356
  152. package/locales/sv.json +298 -301
  153. package/locales/sw.json +131 -134
  154. package/locales/ta.json +353 -356
  155. package/locales/te.json +351 -354
  156. package/locales/th.json +353 -356
  157. package/locales/tr.json +328 -331
  158. package/locales/uk.json +352 -355
  159. package/locales/ur.json +353 -356
  160. package/locales/uz.json +235 -238
  161. package/locales/vi.json +353 -356
  162. package/locales/zh-HK.json +353 -356
  163. package/locales/zh-TW.json +352 -355
  164. package/locales/zh.json +352 -355
  165. package/locales/zu.json +130 -133
  166. package/models/cpu_profile/CPUProfileDataModel.js +517 -0
  167. package/models/cpu_profile/CPUProfileDataModel.js.map +1 -0
  168. package/models/cpu_profile/ProfileTreeModel.js +90 -0
  169. package/models/cpu_profile/ProfileTreeModel.js.map +1 -0
  170. package/models/cpu_profile/bundle-tsconfig.json +59 -0
  171. package/models/cpu_profile/bundle-tsconfig.ref.json +27 -0
  172. package/models/cpu_profile/cpu_profile-tsconfig.json +63 -0
  173. package/models/cpu_profile/cpu_profile-tsconfig.ref.json +31 -0
  174. package/models/cpu_profile/cpu_profile.js +7 -0
  175. package/models/cpu_profile/cpu_profile.js.map +1 -0
  176. package/models/cpu_profile/cpu_profile_node_typecheck-tsconfig.json +60 -0
  177. package/models/cpu_profile/cpu_profile_node_typecheck.stamp +0 -0
  178. package/models/cpu_profile/foundation_unittests-tsconfig.json +63 -0
  179. package/models/cpu_profile/foundation_unittests-tsconfig.ref.json +30 -0
  180. package/models/cpu_profile/foundation_unittests_node_typecheck-tsconfig.json +59 -0
  181. package/models/crux-manager/crux-manager.d.ts +3 -1
  182. package/models/crux-manager/crux-manager.js +1 -0
  183. package/models/trace/EntityMapper.js +133 -0
  184. package/models/trace/EntityMapper.js.map +1 -0
  185. package/models/trace/EventsSerializer.d.ts +1 -0
  186. package/models/trace/EventsSerializer.js +118 -0
  187. package/models/trace/EventsSerializer.js.map +1 -0
  188. package/models/trace/LanternComputationData.js +368 -0
  189. package/models/trace/LanternComputationData.js.map +1 -0
  190. package/models/trace/ModelImpl.js +181 -0
  191. package/models/trace/ModelImpl.js.map +1 -0
  192. package/models/trace/Name.js +115 -0
  193. package/models/trace/Name.js.map +1 -0
  194. package/models/trace/Processor.js +616 -0
  195. package/models/trace/Processor.js.map +1 -0
  196. package/models/trace/Styles.d.ts +2 -2
  197. package/models/trace/Styles.js +836 -0
  198. package/models/trace/Styles.js.map +1 -0
  199. package/models/trace/bundle-tsconfig.json +77 -0
  200. package/models/trace/bundle-tsconfig.ref.json +45 -0
  201. package/models/trace/extras/FilmStrip.js +45 -0
  202. package/models/trace/extras/FilmStrip.js.map +1 -0
  203. package/models/trace/extras/Initiators.js +47 -0
  204. package/models/trace/extras/Initiators.js.map +1 -0
  205. package/models/trace/extras/MainThreadActivity.js +77 -0
  206. package/models/trace/extras/MainThreadActivity.js.map +1 -0
  207. package/models/trace/extras/ScriptDuplication.js +163 -0
  208. package/models/trace/extras/ScriptDuplication.js.map +1 -0
  209. package/models/trace/extras/StackTraceForEvent.d.ts +1 -1
  210. package/models/trace/extras/StackTraceForEvent.js +192 -0
  211. package/models/trace/extras/StackTraceForEvent.js.map +1 -0
  212. package/models/trace/extras/ThirdParties.js +119 -0
  213. package/models/trace/extras/ThirdParties.js.map +1 -0
  214. package/models/trace/extras/TraceFilter.js +51 -0
  215. package/models/trace/extras/TraceFilter.js.map +1 -0
  216. package/models/trace/extras/TraceTree.js +652 -0
  217. package/models/trace/extras/TraceTree.js.map +1 -0
  218. package/models/trace/extras/bundle-tsconfig.json +59 -0
  219. package/models/trace/extras/bundle-tsconfig.ref.json +27 -0
  220. package/models/trace/extras/extras-tsconfig.json +81 -0
  221. package/models/trace/extras/extras-tsconfig.ref.json +49 -0
  222. package/models/trace/extras/extras.js +12 -0
  223. package/models/trace/extras/extras.js.map +1 -0
  224. package/models/trace/extras/extras_node_typecheck-tsconfig.json +78 -0
  225. package/models/trace/extras/extras_node_typecheck.stamp +0 -0
  226. package/models/trace/extras/foundation_unittests-tsconfig.json +91 -0
  227. package/models/trace/extras/foundation_unittests-tsconfig.ref.json +58 -0
  228. package/models/trace/extras/foundation_unittests_node_typecheck-tsconfig.json +87 -0
  229. package/models/trace/foundation_unittests-tsconfig.json +70 -0
  230. package/models/trace/foundation_unittests-tsconfig.ref.json +37 -0
  231. package/models/trace/foundation_unittests_node_typecheck-tsconfig.json +66 -0
  232. package/models/trace/handlers/AnimationFramesHandler.d.ts +1 -1
  233. package/models/trace/handlers/AnimationFramesHandler.js +110 -0
  234. package/models/trace/handlers/AnimationFramesHandler.js.map +1 -0
  235. package/models/trace/handlers/AnimationHandler.js +27 -0
  236. package/models/trace/handlers/AnimationHandler.js.map +1 -0
  237. package/models/trace/handlers/AsyncJSCallsHandler.d.ts +2 -2
  238. package/models/trace/handlers/AsyncJSCallsHandler.js +188 -0
  239. package/models/trace/handlers/AsyncJSCallsHandler.js.map +1 -0
  240. package/models/trace/handlers/DOMStatsHandler.js +22 -0
  241. package/models/trace/handlers/DOMStatsHandler.js.map +1 -0
  242. package/models/trace/handlers/ExtensionTraceDataHandler.js +264 -0
  243. package/models/trace/handlers/ExtensionTraceDataHandler.js.map +1 -0
  244. package/models/trace/handlers/FlowsHandler.js +149 -0
  245. package/models/trace/handlers/FlowsHandler.js.map +1 -0
  246. package/models/trace/handlers/FramesHandler.js +491 -0
  247. package/models/trace/handlers/FramesHandler.js.map +1 -0
  248. package/models/trace/handlers/GPUHandler.js +36 -0
  249. package/models/trace/handlers/GPUHandler.js.map +1 -0
  250. package/models/trace/handlers/ImagePaintingHandler.d.ts +2 -2
  251. package/models/trace/handlers/ImagePaintingHandler.js +148 -0
  252. package/models/trace/handlers/ImagePaintingHandler.js.map +1 -0
  253. package/models/trace/handlers/InitiatorsHandler.d.ts +2 -2
  254. package/models/trace/handlers/InitiatorsHandler.js +181 -0
  255. package/models/trace/handlers/InitiatorsHandler.js.map +1 -0
  256. package/models/trace/handlers/InvalidationsHandler.js +125 -0
  257. package/models/trace/handlers/InvalidationsHandler.js.map +1 -0
  258. package/models/trace/handlers/LargestImagePaintHandler.js +86 -0
  259. package/models/trace/handlers/LargestImagePaintHandler.js.map +1 -0
  260. package/models/trace/handlers/LargestTextPaintHandler.js +28 -0
  261. package/models/trace/handlers/LargestTextPaintHandler.js.map +1 -0
  262. package/models/trace/handlers/LayerTreeHandler.d.ts +1 -1
  263. package/models/trace/handlers/LayerTreeHandler.js +104 -0
  264. package/models/trace/handlers/LayerTreeHandler.js.map +1 -0
  265. package/models/trace/handlers/LayoutShiftsHandler.js +453 -0
  266. package/models/trace/handlers/LayoutShiftsHandler.js.map +1 -0
  267. package/models/trace/handlers/MemoryHandler.js +22 -0
  268. package/models/trace/handlers/MemoryHandler.js.map +1 -0
  269. package/models/trace/handlers/MetaHandler.js +442 -0
  270. package/models/trace/handlers/MetaHandler.js.map +1 -0
  271. package/models/trace/handlers/ModelHandlers.js +33 -0
  272. package/models/trace/handlers/ModelHandlers.js.map +1 -0
  273. package/models/trace/handlers/NetworkRequestsHandler.d.ts +1 -1
  274. package/models/trace/handlers/NetworkRequestsHandler.js +578 -0
  275. package/models/trace/handlers/NetworkRequestsHandler.js.map +1 -0
  276. package/models/trace/handlers/PageFramesHandler.js +43 -0
  277. package/models/trace/handlers/PageFramesHandler.js.map +1 -0
  278. package/models/trace/handlers/PageLoadMetricsHandler.d.ts +1 -1
  279. package/models/trace/handlers/PageLoadMetricsHandler.js +463 -0
  280. package/models/trace/handlers/PageLoadMetricsHandler.js.map +1 -0
  281. package/models/trace/handlers/RendererHandler.js +346 -0
  282. package/models/trace/handlers/RendererHandler.js.map +1 -0
  283. package/models/trace/handlers/SamplesHandler.js +261 -0
  284. package/models/trace/handlers/SamplesHandler.js.map +1 -0
  285. package/models/trace/handlers/ScreenshotsHandler.js +56 -0
  286. package/models/trace/handlers/ScreenshotsHandler.js.map +1 -0
  287. package/models/trace/handlers/ScriptsHandler.d.ts +1 -1
  288. package/models/trace/handlers/ScriptsHandler.js +277 -0
  289. package/models/trace/handlers/ScriptsHandler.js.map +1 -0
  290. package/models/trace/handlers/SelectorStatsHandler.js +72 -0
  291. package/models/trace/handlers/SelectorStatsHandler.js.map +1 -0
  292. package/models/trace/handlers/Threads.js +108 -0
  293. package/models/trace/handlers/Threads.js.map +1 -0
  294. package/models/trace/handlers/UserInteractionsHandler.js +319 -0
  295. package/models/trace/handlers/UserInteractionsHandler.js.map +1 -0
  296. package/models/trace/handlers/UserTimingsHandler.js +194 -0
  297. package/models/trace/handlers/UserTimingsHandler.js.map +1 -0
  298. package/models/trace/handlers/WarningsHandler.d.ts +1 -1
  299. package/models/trace/handlers/WarningsHandler.js +135 -0
  300. package/models/trace/handlers/WarningsHandler.js.map +1 -0
  301. package/models/trace/handlers/WorkersHandler.js +34 -0
  302. package/models/trace/handlers/WorkersHandler.js.map +1 -0
  303. package/models/trace/handlers/bundle-tsconfig.json +59 -0
  304. package/models/trace/handlers/bundle-tsconfig.ref.json +27 -0
  305. package/models/trace/handlers/foundation_unittests-tsconfig.json +102 -0
  306. package/models/trace/handlers/foundation_unittests-tsconfig.ref.json +69 -0
  307. package/models/trace/handlers/foundation_unittests_node_typecheck-tsconfig.json +98 -0
  308. package/models/trace/handlers/handlers-tsconfig.json +112 -0
  309. package/models/trace/handlers/handlers-tsconfig.ref.json +80 -0
  310. package/models/trace/handlers/handlers.js +8 -0
  311. package/models/trace/handlers/handlers.js.map +1 -0
  312. package/models/trace/handlers/handlers_node_typecheck-tsconfig.json +109 -0
  313. package/models/trace/handlers/handlers_node_typecheck.stamp +0 -0
  314. package/models/trace/handlers/helpers.js +167 -0
  315. package/models/trace/handlers/helpers.js.map +1 -0
  316. package/models/trace/handlers/types.js +2 -0
  317. package/models/trace/handlers/types.js.map +1 -0
  318. package/models/trace/helpers/Extensions.js +42 -0
  319. package/models/trace/helpers/Extensions.js.map +1 -0
  320. package/models/trace/helpers/Network.js +103 -0
  321. package/models/trace/helpers/Network.js.map +1 -0
  322. package/models/trace/helpers/SamplesIntegrator.d.ts +3 -1
  323. package/models/trace/helpers/SamplesIntegrator.js +527 -0
  324. package/models/trace/helpers/SamplesIntegrator.js.map +1 -0
  325. package/models/trace/helpers/SyntheticEvents.js +96 -0
  326. package/models/trace/helpers/SyntheticEvents.js.map +1 -0
  327. package/models/trace/helpers/Timing.js +200 -0
  328. package/models/trace/helpers/Timing.js.map +1 -0
  329. package/models/trace/helpers/Trace.d.ts +2 -0
  330. package/models/trace/helpers/Trace.js +844 -0
  331. package/models/trace/helpers/Trace.js.map +1 -0
  332. package/models/trace/helpers/TreeHelpers.js +255 -0
  333. package/models/trace/helpers/TreeHelpers.js.map +1 -0
  334. package/models/trace/helpers/bundle-tsconfig.json +59 -0
  335. package/models/trace/helpers/bundle-tsconfig.ref.json +27 -0
  336. package/models/trace/helpers/foundation_unittests-tsconfig.json +73 -0
  337. package/models/trace/helpers/foundation_unittests-tsconfig.ref.json +40 -0
  338. package/models/trace/helpers/foundation_unittests_node_typecheck-tsconfig.json +69 -0
  339. package/models/trace/helpers/helpers-tsconfig.json +77 -0
  340. package/models/trace/helpers/helpers-tsconfig.ref.json +45 -0
  341. package/models/trace/helpers/helpers.js +11 -0
  342. package/models/trace/helpers/helpers.js.map +1 -0
  343. package/models/trace/helpers/helpers_node_typecheck-tsconfig.json +74 -0
  344. package/models/trace/helpers/helpers_node_typecheck.stamp +0 -0
  345. package/models/trace/insights/CLSCulprits.d.ts +14 -14
  346. package/models/trace/insights/CLSCulprits.js +519 -0
  347. package/models/trace/insights/CLSCulprits.js.map +1 -0
  348. package/models/trace/insights/Cache.d.ts +6 -6
  349. package/models/trace/insights/Cache.js +210 -0
  350. package/models/trace/insights/Cache.js.map +1 -0
  351. package/models/trace/insights/CharacterSet.d.ts +8 -8
  352. package/models/trace/insights/CharacterSet.js +132 -0
  353. package/models/trace/insights/CharacterSet.js.map +1 -0
  354. package/models/trace/insights/Common.js +367 -0
  355. package/models/trace/insights/Common.js.map +1 -0
  356. package/models/trace/insights/DOMSize.d.ts +13 -13
  357. package/models/trace/insights/DOMSize.js +182 -0
  358. package/models/trace/insights/DOMSize.js.map +1 -0
  359. package/models/trace/insights/DocumentLatency.d.ts +11 -11
  360. package/models/trace/insights/DocumentLatency.js +259 -0
  361. package/models/trace/insights/DocumentLatency.js.map +1 -0
  362. package/models/trace/insights/DuplicatedJavaScript.d.ts +6 -6
  363. package/models/trace/insights/DuplicatedJavaScript.js +110 -0
  364. package/models/trace/insights/DuplicatedJavaScript.js.map +1 -0
  365. package/models/trace/insights/FontDisplay.d.ts +5 -5
  366. package/models/trace/insights/FontDisplay.js +93 -0
  367. package/models/trace/insights/FontDisplay.js.map +1 -0
  368. package/models/trace/insights/ForcedReflow.d.ts +7 -7
  369. package/models/trace/insights/ForcedReflow.js +162 -0
  370. package/models/trace/insights/ForcedReflow.js.map +1 -0
  371. package/models/trace/insights/INPBreakdown.d.ts +8 -8
  372. package/models/trace/insights/INPBreakdown.js +130 -0
  373. package/models/trace/insights/INPBreakdown.js.map +1 -0
  374. package/models/trace/insights/ImageDelivery.d.ts +13 -12
  375. package/models/trace/insights/ImageDelivery.js +264 -0
  376. package/models/trace/insights/ImageDelivery.js.map +1 -0
  377. package/models/trace/insights/LCPBreakdown.d.ts +11 -11
  378. package/models/trace/insights/LCPBreakdown.js +200 -0
  379. package/models/trace/insights/LCPBreakdown.js.map +1 -0
  380. package/models/trace/insights/LCPDiscovery.d.ts +10 -10
  381. package/models/trace/insights/LCPDiscovery.js +190 -0
  382. package/models/trace/insights/LCPDiscovery.js.map +1 -0
  383. package/models/trace/insights/LegacyJavaScript.d.ts +5 -5
  384. package/models/trace/insights/LegacyJavaScript.js +99 -0
  385. package/models/trace/insights/LegacyJavaScript.js.map +1 -0
  386. package/models/trace/insights/Models.js +23 -0
  387. package/models/trace/insights/Models.js.map +1 -0
  388. package/models/trace/insights/ModernHTTP.d.ts +5 -5
  389. package/models/trace/insights/ModernHTTP.js +205 -0
  390. package/models/trace/insights/ModernHTTP.js.map +1 -0
  391. package/models/trace/insights/NetworkDependencyTree.d.ts +19 -19
  392. package/models/trace/insights/NetworkDependencyTree.js +551 -0
  393. package/models/trace/insights/NetworkDependencyTree.js.map +1 -0
  394. package/models/trace/insights/RenderBlocking.d.ts +5 -5
  395. package/models/trace/insights/RenderBlocking.js +211 -0
  396. package/models/trace/insights/RenderBlocking.js.map +1 -0
  397. package/models/trace/insights/SlowCSSSelector.d.ts +10 -10
  398. package/models/trace/insights/SlowCSSSelector.js +140 -0
  399. package/models/trace/insights/SlowCSSSelector.js.map +1 -0
  400. package/models/trace/insights/Statistics.js +93 -0
  401. package/models/trace/insights/Statistics.js.map +1 -0
  402. package/models/trace/insights/ThirdParties.d.ts +6 -6
  403. package/models/trace/insights/ThirdParties.js +110 -0
  404. package/models/trace/insights/ThirdParties.js.map +1 -0
  405. package/models/trace/insights/Viewport.d.ts +3 -3
  406. package/models/trace/insights/Viewport.js +105 -0
  407. package/models/trace/insights/Viewport.js.map +1 -0
  408. package/models/trace/insights/bundle-tsconfig.json +59 -0
  409. package/models/trace/insights/bundle-tsconfig.ref.json +27 -0
  410. package/models/trace/insights/foundation_unittests-tsconfig.json +98 -0
  411. package/models/trace/insights/foundation_unittests-tsconfig.ref.json +65 -0
  412. package/models/trace/insights/foundation_unittests_node_typecheck-tsconfig.json +94 -0
  413. package/models/trace/insights/insights-tsconfig.json +114 -0
  414. package/models/trace/insights/insights-tsconfig.ref.json +82 -0
  415. package/models/trace/insights/insights.js +10 -0
  416. package/models/trace/insights/insights.js.map +1 -0
  417. package/models/trace/insights/insights_node_typecheck-tsconfig.json +111 -0
  418. package/models/trace/insights/insights_node_typecheck.stamp +0 -0
  419. package/models/trace/insights/types.d.ts +3 -3
  420. package/models/trace/insights/types.js +41 -0
  421. package/models/trace/insights/types.js.map +1 -0
  422. package/models/trace/lantern/bundle-tsconfig.json +71 -0
  423. package/models/trace/lantern/bundle-tsconfig.ref.json +39 -0
  424. package/models/trace/lantern/core/LanternError.js +7 -0
  425. package/models/trace/lantern/core/LanternError.js.map +1 -0
  426. package/models/trace/lantern/core/NetworkAnalyzer.d.ts +1 -0
  427. package/models/trace/lantern/core/NetworkAnalyzer.js +496 -0
  428. package/models/trace/lantern/core/NetworkAnalyzer.js.map +1 -0
  429. package/models/trace/lantern/core/bundle-tsconfig.json +59 -0
  430. package/models/trace/lantern/core/bundle-tsconfig.ref.json +27 -0
  431. package/models/trace/lantern/core/core-tsconfig.json +60 -0
  432. package/models/trace/lantern/core/core-tsconfig.ref.json +28 -0
  433. package/models/trace/lantern/core/core.js +6 -0
  434. package/models/trace/lantern/core/core.js.map +1 -0
  435. package/models/trace/lantern/core/core_node_typecheck-tsconfig.json +57 -0
  436. package/models/trace/lantern/core/core_node_typecheck.stamp +0 -0
  437. package/models/trace/lantern/core/foundation_unittests-tsconfig.json +69 -0
  438. package/models/trace/lantern/core/foundation_unittests-tsconfig.ref.json +36 -0
  439. package/models/trace/lantern/core/foundation_unittests_node_typecheck-tsconfig.json +65 -0
  440. package/models/trace/lantern/graph/BaseNode.d.ts +2 -2
  441. package/models/trace/lantern/graph/BaseNode.js +277 -0
  442. package/models/trace/lantern/graph/BaseNode.js.map +1 -0
  443. package/models/trace/lantern/graph/CPUNode.d.ts +4 -2
  444. package/models/trace/lantern/graph/CPUNode.js +80 -0
  445. package/models/trace/lantern/graph/CPUNode.js.map +1 -0
  446. package/models/trace/lantern/graph/NetworkNode.js +95 -0
  447. package/models/trace/lantern/graph/NetworkNode.js.map +1 -0
  448. package/models/trace/lantern/graph/PageDependencyGraph.js +574 -0
  449. package/models/trace/lantern/graph/PageDependencyGraph.js.map +1 -0
  450. package/models/trace/lantern/graph/bundle-tsconfig.json +59 -0
  451. package/models/trace/lantern/graph/bundle-tsconfig.ref.json +27 -0
  452. package/models/trace/lantern/graph/foundation_unittests-tsconfig.json +61 -0
  453. package/models/trace/lantern/graph/foundation_unittests-tsconfig.ref.json +28 -0
  454. package/models/trace/lantern/graph/foundation_unittests_node_typecheck-tsconfig.json +57 -0
  455. package/models/trace/lantern/graph/graph-tsconfig.json +65 -0
  456. package/models/trace/lantern/graph/graph-tsconfig.ref.json +33 -0
  457. package/models/trace/lantern/graph/graph.js +8 -0
  458. package/models/trace/lantern/graph/graph.js.map +1 -0
  459. package/models/trace/lantern/graph/graph_node_typecheck-tsconfig.json +62 -0
  460. package/models/trace/lantern/graph/graph_node_typecheck.stamp +0 -0
  461. package/models/trace/lantern/lantern.js +10 -0
  462. package/models/trace/lantern/lantern.js.map +1 -0
  463. package/models/trace/lantern/metrics/FirstContentfulPaint.js +137 -0
  464. package/models/trace/lantern/metrics/FirstContentfulPaint.js.map +1 -0
  465. package/models/trace/lantern/metrics/Interactive.js +68 -0
  466. package/models/trace/lantern/metrics/Interactive.js.map +1 -0
  467. package/models/trace/lantern/metrics/LargestContentfulPaint.js +75 -0
  468. package/models/trace/lantern/metrics/LargestContentfulPaint.js.map +1 -0
  469. package/models/trace/lantern/metrics/MaxPotentialFID.js +49 -0
  470. package/models/trace/lantern/metrics/MaxPotentialFID.js.map +1 -0
  471. package/models/trace/lantern/metrics/Metric.js +69 -0
  472. package/models/trace/lantern/metrics/Metric.js.map +1 -0
  473. package/models/trace/lantern/metrics/SpeedIndex.js +102 -0
  474. package/models/trace/lantern/metrics/SpeedIndex.js.map +1 -0
  475. package/models/trace/lantern/metrics/TBTUtils.js +65 -0
  476. package/models/trace/lantern/metrics/TBTUtils.js.map +1 -0
  477. package/models/trace/lantern/metrics/TotalBlockingTime.js +79 -0
  478. package/models/trace/lantern/metrics/TotalBlockingTime.js.map +1 -0
  479. package/models/trace/lantern/metrics/bundle-tsconfig.json +59 -0
  480. package/models/trace/lantern/metrics/bundle-tsconfig.ref.json +27 -0
  481. package/models/trace/lantern/metrics/foundation_unittests-tsconfig.json +76 -0
  482. package/models/trace/lantern/metrics/foundation_unittests-tsconfig.ref.json +43 -0
  483. package/models/trace/lantern/metrics/foundation_unittests_node_typecheck-tsconfig.json +72 -0
  484. package/models/trace/lantern/metrics/metrics-tsconfig.json +75 -0
  485. package/models/trace/lantern/metrics/metrics-tsconfig.ref.json +43 -0
  486. package/models/trace/lantern/metrics/metrics.js +12 -0
  487. package/models/trace/lantern/metrics/metrics.js.map +1 -0
  488. package/models/trace/lantern/metrics/metrics_node_typecheck-tsconfig.json +72 -0
  489. package/models/trace/lantern/metrics/metrics_node_typecheck.stamp +0 -0
  490. package/models/trace/lantern/simulation/ConnectionPool.js +116 -0
  491. package/models/trace/lantern/simulation/ConnectionPool.js.map +1 -0
  492. package/models/trace/lantern/simulation/Constants.js +45 -0
  493. package/models/trace/lantern/simulation/Constants.js.map +1 -0
  494. package/models/trace/lantern/simulation/DNSCache.js +48 -0
  495. package/models/trace/lantern/simulation/DNSCache.js.map +1 -0
  496. package/models/trace/lantern/simulation/SimulationTimingMap.js +135 -0
  497. package/models/trace/lantern/simulation/SimulationTimingMap.js.map +1 -0
  498. package/models/trace/lantern/simulation/Simulator.js +457 -0
  499. package/models/trace/lantern/simulation/Simulator.js.map +1 -0
  500. package/models/trace/lantern/simulation/TCPConnection.d.ts +4 -4
  501. package/models/trace/lantern/simulation/TCPConnection.js +155 -0
  502. package/models/trace/lantern/simulation/TCPConnection.js.map +1 -0
  503. package/models/trace/lantern/simulation/bundle-tsconfig.json +59 -0
  504. package/models/trace/lantern/simulation/bundle-tsconfig.ref.json +27 -0
  505. package/models/trace/lantern/simulation/foundation_unittests-tsconfig.json +75 -0
  506. package/models/trace/lantern/simulation/foundation_unittests-tsconfig.ref.json +42 -0
  507. package/models/trace/lantern/simulation/foundation_unittests_node_typecheck-tsconfig.json +71 -0
  508. package/models/trace/lantern/simulation/simulation-tsconfig.json +70 -0
  509. package/models/trace/lantern/simulation/simulation-tsconfig.ref.json +38 -0
  510. package/models/trace/lantern/simulation/simulation.js +10 -0
  511. package/models/trace/lantern/simulation/simulation.js.map +1 -0
  512. package/models/trace/lantern/simulation/simulation_node_typecheck-tsconfig.json +67 -0
  513. package/models/trace/lantern/simulation/simulation_node_typecheck.stamp +0 -0
  514. package/models/trace/lantern/testing/bundle-tsconfig.json +60 -0
  515. package/models/trace/lantern/testing/bundle-tsconfig.ref.json +27 -0
  516. package/models/trace/lantern/testing/testing-tsconfig.json +63 -0
  517. package/models/trace/lantern/testing/testing-tsconfig.ref.json +30 -0
  518. package/models/trace/lantern/types/Lantern.d.ts +34 -19
  519. package/models/trace/lantern/types/Lantern.js +25 -0
  520. package/models/trace/lantern/types/Lantern.js.map +1 -0
  521. package/models/trace/lantern/types/bundle-tsconfig.json +59 -0
  522. package/models/trace/lantern/types/bundle-tsconfig.ref.json +27 -0
  523. package/models/trace/lantern/types/types-tsconfig.json +59 -0
  524. package/models/trace/lantern/types/types-tsconfig.ref.json +27 -0
  525. package/models/trace/lantern/types/types.js +5 -0
  526. package/models/trace/lantern/types/types.js.map +1 -0
  527. package/models/trace/lantern/types/types_node_typecheck-tsconfig.json +56 -0
  528. package/models/trace/lantern/types/types_node_typecheck.stamp +0 -0
  529. package/models/trace/trace-tsconfig.json +89 -0
  530. package/models/trace/trace-tsconfig.ref.json +57 -0
  531. package/models/trace/trace.js +16 -544
  532. package/models/trace/trace.js.map +1 -0
  533. package/models/trace/trace_node_typecheck-tsconfig.json +86 -0
  534. package/models/trace/trace_node_typecheck.stamp +0 -0
  535. package/models/trace/types/Configuration.d.ts +2 -2
  536. package/models/trace/types/Configuration.js +19 -0
  537. package/models/trace/types/Configuration.js.map +1 -0
  538. package/models/trace/types/Extensions.d.ts +1 -1
  539. package/models/trace/types/Extensions.js +38 -0
  540. package/models/trace/types/Extensions.js.map +1 -0
  541. package/models/trace/types/File.d.ts +9 -3
  542. package/models/trace/types/File.js +92 -0
  543. package/models/trace/types/File.js.map +1 -0
  544. package/models/trace/types/Overlays.d.ts +4 -3
  545. package/models/trace/types/Overlays.js +5 -0
  546. package/models/trace/types/Overlays.js.map +1 -0
  547. package/models/trace/types/Timing.js +16 -0
  548. package/models/trace/types/Timing.js.map +1 -0
  549. package/models/trace/types/TraceEvents.d.ts +205 -140
  550. package/models/trace/types/TraceEvents.js +983 -0
  551. package/models/trace/types/TraceEvents.js.map +1 -0
  552. package/models/trace/types/bundle-tsconfig.json +59 -0
  553. package/models/trace/types/bundle-tsconfig.ref.json +27 -0
  554. package/models/trace/types/foundation_unittests-tsconfig.json +67 -0
  555. package/models/trace/types/foundation_unittests-tsconfig.ref.json +34 -0
  556. package/models/trace/types/foundation_unittests_node_typecheck-tsconfig.json +63 -0
  557. package/models/trace/types/types-tsconfig.json +76 -0
  558. package/models/trace/types/types-tsconfig.ref.json +44 -0
  559. package/models/trace/types/types.js +10 -0
  560. package/models/trace/types/types.js.map +1 -0
  561. package/models/trace/types/types_node_typecheck-tsconfig.json +73 -0
  562. package/models/trace/types/types_node_typecheck.stamp +0 -0
  563. package/package.json +8 -37
  564. package/test/invalid-animation-events.json.gz +0 -0
  565. package/test/test-trace-engine.mjs +191 -0
  566. package/third_party/legacy-javascript/bundle-tsconfig.json +59 -0
  567. package/third_party/legacy-javascript/bundle-tsconfig.ref.json +27 -0
  568. package/third_party/legacy-javascript/legacy-javascript-tsconfig.ref.json +15 -0
  569. package/third_party/legacy-javascript/legacy-javascript.js +3 -0
  570. package/third_party/legacy-javascript/legacy-javascript.js.map +1 -0
  571. package/third_party/legacy-javascript/lib/legacy-javascript.js +1119 -0
  572. package/third_party/marked/marked.d.ts +1 -0
  573. package/third_party/marked/marked.js +1 -0
  574. package/third_party/third-party-web/third-party-web.d.ts +1 -2
  575. package/third_party/third-party-web/third-party-web.js +1 -0
  576. package/tsconfig.json +29 -0
  577. package/core/common/Base64.d.ts +0 -12
  578. package/core/common/CharacterIdMap.d.ts +0 -5
  579. package/core/common/Color.d.ts +0 -357
  580. package/core/common/ColorConverter.d.ts +0 -26
  581. package/core/common/ColorUtils.d.ts +0 -45
  582. package/core/common/Console.d.ts +0 -54
  583. package/core/common/Debouncer.d.ts +0 -8
  584. package/core/common/EventTarget.d.ts +0 -22
  585. package/core/common/Gzip.d.ts +0 -23
  586. package/core/common/JavaScriptMetaData.d.ts +0 -20
  587. package/core/common/Lazy.d.ts +0 -4
  588. package/core/common/MapWithDefault.d.ts +0 -9
  589. package/core/common/Mutex.d.ts +0 -13
  590. package/core/common/Object.d.ts +0 -20
  591. package/core/common/Progress.d.ts +0 -47
  592. package/core/common/ResolverBase.d.ts +0 -29
  593. package/core/common/ResourceType.d.ts +0 -52
  594. package/core/common/ReturnToPanel.d.ts +0 -10
  595. package/core/common/Revealer.d.ts +0 -66
  596. package/core/common/Runnable.d.ts +0 -14
  597. package/core/common/SegmentedRange.d.ts +0 -14
  598. package/core/common/SettingRegistration.d.ts +0 -136
  599. package/core/common/Settings.d.ts +0 -226
  600. package/core/common/SimpleHistoryManager.d.ts +0 -20
  601. package/core/common/Srcset.d.ts +0 -16
  602. package/core/common/StringOutputStream.d.ts +0 -10
  603. package/core/common/TextDictionary.d.ts +0 -11
  604. package/core/common/Throttler.d.ts +0 -12
  605. package/core/common/Trie.d.ts +0 -24
  606. package/core/common/VersionController.d.ts +0 -85
  607. package/core/host/AidaClient.d.ts +0 -73
  608. package/core/host/AidaClientTypes.d.ts +0 -355
  609. package/core/host/AidaGcaTranslation.d.ts +0 -10
  610. package/core/host/DispatchHttpRequestClient.d.ts +0 -14
  611. package/core/host/GcaClient.d.ts +0 -14
  612. package/core/host/GcaTypes.d.ts +0 -411
  613. package/core/host/GdpClient.d.ts +0 -84
  614. package/core/host/InspectorFrontendHost.d.ts +0 -29
  615. package/core/host/InspectorFrontendHostAPI.d.ts +0 -425
  616. package/core/host/InspectorFrontendHostStub.d.ts +0 -151
  617. package/core/host/Platform.d.ts +0 -11
  618. package/core/host/ResourceLoader.d.ts +0 -15
  619. package/core/host/UserMetrics.d.ts +0 -116
  620. package/core/host/UserMetricsEnums.d.ts +0 -883
  621. package/core/i18n/ByteUtilities.d.ts +0 -11
  622. package/core/i18n/DevToolsLocale.d.ts +0 -41
  623. package/core/i18n/NumberFormatter.d.ts +0 -11
  624. package/core/i18n/i18nImpl.d.ts +0 -64
  625. package/core/i18n/i18nTypes.d.ts +0 -5
  626. package/core/i18n/locales.d.ts +0 -15
  627. package/core/i18n/time-utilities.d.ts +0 -16
  628. package/core/platform/browser/HostRuntime.d.ts +0 -2
  629. package/core/platform/browser/browser.d.ts +0 -2
  630. package/core/platform/node/HostRuntime.d.ts +0 -2
  631. package/core/platform/node/node.d.ts +0 -2
  632. package/core/protocol_client/CDPConnection.d.ts +0 -77
  633. package/core/protocol_client/ConnectionTransport.d.ts +0 -9
  634. package/core/protocol_client/DevToolsCDPConnection.d.ts +0 -16
  635. package/core/protocol_client/InspectorBackend.d.ts +0 -223
  636. package/core/protocol_client/protocol_client.d.ts +0 -5
  637. package/core/root/DevToolsContext.d.ts +0 -34
  638. package/core/root/ExperimentNames.d.ts +0 -8
  639. package/core/root/Runtime.d.ts +0 -351
  640. package/core/sdk/AccessibilityModel.d.ts +0 -76
  641. package/core/sdk/AnimationModel.d.ts +0 -161
  642. package/core/sdk/AutofillModel.d.ts +0 -23
  643. package/core/sdk/CPUProfilerModel.d.ts +0 -46
  644. package/core/sdk/CPUThrottlingManager.d.ts +0 -47
  645. package/core/sdk/CSSContainerQuery.d.ts +0 -42
  646. package/core/sdk/CSSFontFace.d.ts +0 -10
  647. package/core/sdk/CSSLayer.d.ts +0 -9
  648. package/core/sdk/CSSLocation.d.ts +0 -14
  649. package/core/sdk/CSSMatchedStyles.d.ts +0 -138
  650. package/core/sdk/CSSMedia.d.ts +0 -36
  651. package/core/sdk/CSSMetadata.d.ts +0 -87
  652. package/core/sdk/CSSModel.d.ts +0 -180
  653. package/core/sdk/CSSNavigation.d.ts +0 -10
  654. package/core/sdk/CSSProperty.d.ts +0 -53
  655. package/core/sdk/CSSPropertyParser.d.ts +0 -131
  656. package/core/sdk/CSSPropertyParserMatchers.d.ts +0 -442
  657. package/core/sdk/CSSQuery.d.ts +0 -22
  658. package/core/sdk/CSSRule.d.ts +0 -132
  659. package/core/sdk/CSSScope.d.ts +0 -9
  660. package/core/sdk/CSSStartingStyle.d.ts +0 -9
  661. package/core/sdk/CSSStyleDeclaration.d.ts +0 -38
  662. package/core/sdk/CSSStyleSheetHeader.d.ts +0 -53
  663. package/core/sdk/CSSSupports.d.ts +0 -10
  664. package/core/sdk/CategorizedBreakpoint.d.ts +0 -42
  665. package/core/sdk/ChildTargetManager.d.ts +0 -40
  666. package/core/sdk/CompilerSourceMappingContentProvider.d.ts +0 -12
  667. package/core/sdk/Connections.d.ts +0 -36
  668. package/core/sdk/ConsoleModel.d.ts +0 -127
  669. package/core/sdk/ConsoleModelTypes.d.ts +0 -6
  670. package/core/sdk/Cookie.d.ts +0 -68
  671. package/core/sdk/CookieModel.d.ts +0 -31
  672. package/core/sdk/CookieParser.d.ts +0 -14
  673. package/core/sdk/CrashReportContextModel.d.ts +0 -8
  674. package/core/sdk/DOMDebuggerModel.d.ts +0 -127
  675. package/core/sdk/DOMModel.d.ts +0 -436
  676. package/core/sdk/DOMStorageModel.d.ts +0 -79
  677. package/core/sdk/DebuggerModel.d.ts +0 -272
  678. package/core/sdk/EmulationModel.d.ts +0 -95
  679. package/core/sdk/EnhancedTracesParser.d.ts +0 -105
  680. package/core/sdk/EventBreakpointsModel.d.ts +0 -66
  681. package/core/sdk/FrameAssociated.d.ts +0 -6
  682. package/core/sdk/FrameManager.d.ts +0 -68
  683. package/core/sdk/HeapProfilerModel.d.ts +0 -75
  684. package/core/sdk/HttpReasonPhraseStrings.d.ts +0 -5
  685. package/core/sdk/IOModel.d.ts +0 -10
  686. package/core/sdk/IsolateManager.d.ts +0 -53
  687. package/core/sdk/IssuesModel.d.ts +0 -28
  688. package/core/sdk/LayerTreeBase.d.ts +0 -70
  689. package/core/sdk/LogModel.d.ts +0 -20
  690. package/core/sdk/NetworkManager.d.ts +0 -418
  691. package/core/sdk/NetworkRequest.d.ts +0 -469
  692. package/core/sdk/NetworkRequestAccess.d.ts +0 -91
  693. package/core/sdk/OverlayColorGenerator.d.ts +0 -14
  694. package/core/sdk/OverlayModel.d.ts +0 -186
  695. package/core/sdk/OverlayPersistentHighlighter.d.ts +0 -116
  696. package/core/sdk/PageFunctions.d.ts +0 -22
  697. package/core/sdk/PageLoad.d.ts +0 -14
  698. package/core/sdk/PageResourceLoader.d.ts +0 -111
  699. package/core/sdk/PaintProfiler.d.ts +0 -43
  700. package/core/sdk/PerformanceMetricsModel.d.ts +0 -12
  701. package/core/sdk/PreloadingModel.d.ts +0 -146
  702. package/core/sdk/RehydratingConnection.d.ts +0 -73
  703. package/core/sdk/RehydratingObject.d.ts +0 -59
  704. package/core/sdk/RemoteObject.d.ts +0 -210
  705. package/core/sdk/Resource.d.ts +0 -36
  706. package/core/sdk/ResourceTreeModel.d.ts +0 -278
  707. package/core/sdk/RuntimeModel.d.ts +0 -163
  708. package/core/sdk/SDKModel.d.ts +0 -30
  709. package/core/sdk/SDKSettings.d.ts +0 -53
  710. package/core/sdk/ScopeTreeCache.d.ts +0 -21
  711. package/core/sdk/ScreenCaptureModel.d.ts +0 -69
  712. package/core/sdk/Script.d.ts +0 -134
  713. package/core/sdk/SecurityOrigin.d.ts +0 -108
  714. package/core/sdk/SecurityOriginManager.d.ts +0 -23
  715. package/core/sdk/ServerSentEvents.d.ts +0 -18
  716. package/core/sdk/ServerSentEventsProtocol.d.ts +0 -18
  717. package/core/sdk/ServerTiming.d.ts +0 -24
  718. package/core/sdk/ServiceWorkerCacheModel.d.ts +0 -71
  719. package/core/sdk/ServiceWorkerManager.d.ts +0 -125
  720. package/core/sdk/SourceMap.d.ts +0 -197
  721. package/core/sdk/SourceMapCache.d.ts +0 -12
  722. package/core/sdk/SourceMapFunctionRanges.d.ts +0 -26
  723. package/core/sdk/SourceMapManager.d.ts +0 -46
  724. package/core/sdk/SourceMapRangeMappings.d.ts +0 -15
  725. package/core/sdk/SourceMapScopeChainEntry.d.ts +0 -23
  726. package/core/sdk/SourceMapScopesInfo.d.ts +0 -109
  727. package/core/sdk/StorageBucketsModel.d.ts +0 -48
  728. package/core/sdk/StorageKeyManager.d.ts +0 -38
  729. package/core/sdk/Target.d.ts +0 -79
  730. package/core/sdk/TargetManager.d.ts +0 -92
  731. package/core/sdk/TraceObject.d.ts +0 -43
  732. package/core/sdk/WebAuthnModel.d.ts +0 -29
  733. package/core/text_utils/CodeMirrorUtils.d.ts +0 -3
  734. package/core/text_utils/ContentData.d.ts +0 -94
  735. package/core/text_utils/ContentProvider.d.ts +0 -42
  736. package/core/text_utils/StaticContentProvider.d.ts +0 -13
  737. package/core/text_utils/StreamingContentData.d.ts +0 -49
  738. package/core/text_utils/Text.d.ts +0 -19
  739. package/core/text_utils/TextCursor.d.ts +0 -9
  740. package/core/text_utils/TextRange.d.ts +0 -81
  741. package/core/text_utils/TextUtils.d.ts +0 -97
  742. package/core/text_utils/WasmDisassembly.d.ts +0 -29
  743. package/core/text_utils/text_utils.d.ts +0 -11
  744. package/entrypoints/formatter_actions/formatter_actions.d.ts +0 -48
  745. package/generated/InspectorBackendCommands.d.ts +0 -14
  746. package/generated/SupportedCSSProperties.d.ts +0 -18
  747. package/generated/protocol-mapping.d.ts +0 -5930
  748. package/generated/protocol-proxy-api.d.ts +0 -5396
  749. package/index.d.ts +0 -2
  750. package/index.js +0 -6
  751. package/models/crux-manager/CrUXManager.d.ts +0 -107
  752. package/models/emulation/DeviceModeModel.d.ts +0 -156
  753. package/models/emulation/EmulatedDevices.d.ts +0 -148
  754. package/models/emulation/emulation.d.ts +0 -3
  755. package/models/formatter/FormatterWorkerPool.d.ts +0 -58
  756. package/models/formatter/ScriptFormatter.d.ts +0 -11
  757. package/models/formatter/formatter.d.ts +0 -3
  758. package/third_party/codemirror.next/codemirror.next.d.ts +0 -9196
  759. package/third_party/i18n/i18n-impl.d.ts +0 -25
  760. package/third_party/i18n/i18n.d.ts +0 -3
  761. package/third_party/i18n/localized-string-set.d.ts +0 -49
  762. package/third_party/intl-messageformat/intl-messageformat.d.ts +0 -1
  763. package/third_party/source-map-scopes-codec/package/src/builder/builder.d.ts +0 -67
  764. package/third_party/source-map-scopes-codec/package/src/builder/safe_builder.d.ts +0 -38
  765. package/third_party/source-map-scopes-codec/package/src/codec.d.ts +0 -48
  766. package/third_party/source-map-scopes-codec/package/src/decode/decode.d.ts +0 -31
  767. package/third_party/source-map-scopes-codec/package/src/encode/encode.d.ts +0 -8
  768. package/third_party/source-map-scopes-codec/package/src/encode/encoder.d.ts +0 -6
  769. package/third_party/source-map-scopes-codec/package/src/mod.d.ts +0 -5
  770. package/third_party/source-map-scopes-codec/package/src/scopes.d.ts +0 -168
  771. package/third_party/source-map-scopes-codec/package/src/util.d.ts +0 -5
  772. package/third_party/source-map-scopes-codec/package/src/vlq.d.ts +0 -14
  773. package/third_party/source-map-scopes-codec/source-map-scopes-codec.d.ts +0 -1
  774. package/third_party/third-party-web/lib/nostats-subset.d.ts +0 -2
  775. package/third_party/third-party-web/package/lib/index.d.ts +0 -34
  776. package/third_party/third-party-web/package/lib/subsets/nostats.d.ts +0 -1
@@ -0,0 +1,210 @@
1
+ // Copyright 2025 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 Helpers from '../helpers/helpers.js';
6
+ import { metricSavingsForWastedBytes } from './Common.js';
7
+ import { linearInterpolation } from './Statistics.js';
8
+ import { InsightCategory, InsightKeys, } from './types.js';
9
+ export const UIStrings = {
10
+ /**
11
+ * @description Title of an insight that provides information and suggestions of resources that could improve their caching.
12
+ */
13
+ title: 'Use efficient cache lifetimes',
14
+ /**
15
+ * @description Text to tell the user about how caching can help improve performance.
16
+ */
17
+ 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).',
18
+ /**
19
+ * @description Column for a font loaded by the page to render text.
20
+ */
21
+ requestColumn: 'Request',
22
+ /**
23
+ * @description Column for a resource cache's Time To Live.
24
+ */
25
+ cacheTTL: 'Cache TTL',
26
+ /**
27
+ * @description Text describing that there were no requests found that need caching.
28
+ */
29
+ noRequestsToCache: 'No requests with inefficient cache policies',
30
+ /**
31
+ * @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.
32
+ * @example {5} PH1
33
+ */
34
+ others: '{PH1} others',
35
+ };
36
+ const str_ = i18n.i18n.registerUIStrings('models/trace/insights/Cache.ts', UIStrings);
37
+ export const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
38
+ // Threshold for cache hits.
39
+ const IGNORE_THRESHOLD_IN_PERCENT = 0.925;
40
+ function finalize(partialModel) {
41
+ return {
42
+ insightKey: InsightKeys.CACHE,
43
+ strings: UIStrings,
44
+ title: i18nString(UIStrings.title),
45
+ description: i18nString(UIStrings.description),
46
+ docs: 'https://developer.chrome.com/docs/performance/insights/cache',
47
+ category: InsightCategory.ALL,
48
+ state: partialModel.requests.length > 0 ? 'fail' : 'pass',
49
+ ...partialModel,
50
+ };
51
+ }
52
+ /**
53
+ * Determines if a request is "cacheable".
54
+ * A request is "cacheable" if it is of the appropriate protocol and resource type
55
+ * (see Helpers.Network.NON_NETWORK_SCHEMES and Helpers.Network.STATIC_RESOURCE_TYPE)
56
+ * and has the appropriate statusCodes.
57
+ */
58
+ export function isCacheable(request) {
59
+ // Caching doesn't make sense for requests not loaded over the network.
60
+ if (Helpers.Network.NON_NETWORK_SCHEMES.includes(request.args.data.protocol)) {
61
+ return false;
62
+ }
63
+ return Boolean(Helpers.Network.CACHEABLE_STATUS_CODES.has(request.args.data.statusCode) &&
64
+ Helpers.Network.STATIC_RESOURCE_TYPES.has(request.args.data.resourceType || "Other" /* Protocol.Network.ResourceType.Other */));
65
+ }
66
+ /**
67
+ * Returns max-age if defined, otherwise expires header if defined, and null if not.
68
+ */
69
+ export function computeCacheLifetimeInSeconds(headers, cacheControl) {
70
+ if (cacheControl?.['max-age'] !== undefined) {
71
+ return cacheControl['max-age'];
72
+ }
73
+ const expiresHeaders = headers.find(h => h.name === 'expires')?.value ?? null;
74
+ if (expiresHeaders) {
75
+ const expires = new Date(expiresHeaders).getTime();
76
+ // Treat expires values as having already expired.
77
+ if (!expires) {
78
+ return 0;
79
+ }
80
+ return Math.ceil((expires - Date.now()) / 1000);
81
+ }
82
+ return null;
83
+ }
84
+ /**
85
+ * Computes the percent likelihood that a return visit will be within the cache lifetime, based on
86
+ * historical Chrome UMA stats (see RESOURCE_AGE_IN_HOURS_DECILES comment).
87
+ *
88
+ * This function returns values on this curve: https://www.desmos.com/calculator/eaqiszhugy (but using seconds, rather than hours)
89
+ * See http://github.com/GoogleChrome/lighthouse/pull/3531 for history.
90
+ */
91
+ function getCacheHitProbability(maxAgeInSeconds) {
92
+ // This array contains the hand wavy distribution of the age of a resource in hours at the time of
93
+ // cache hit at 0th, 10th, 20th, 30th, etc percentiles. This is used to compute `wastedMs` since there
94
+ // are clearly diminishing returns to cache duration i.e. 6 months is not 2x better than 3 months.
95
+ // Based on UMA stats for HttpCache.StaleEntry.Validated.Age. see https://www.desmos.com/calculator/jjwc5mzuwd
96
+ // This UMA data is from 2017 but the metric isn't tracked any longer in 2025.
97
+ const RESOURCE_AGE_IN_HOURS_DECILES = [0, 0.2, 1, 3, 8, 12, 24, 48, 72, 168, 8760, Infinity];
98
+ const maxAgeInHours = maxAgeInSeconds / 3600;
99
+ const upperDecileIndex = RESOURCE_AGE_IN_HOURS_DECILES.findIndex(decile => decile >= maxAgeInHours);
100
+ // Clip the likelihood between 0 and 1
101
+ if (upperDecileIndex === RESOURCE_AGE_IN_HOURS_DECILES.length - 1) {
102
+ return 1;
103
+ }
104
+ if (upperDecileIndex === 0) {
105
+ return 0;
106
+ }
107
+ // Use the two closest decile points as control points
108
+ const upperDecileValue = RESOURCE_AGE_IN_HOURS_DECILES[upperDecileIndex];
109
+ const lowerDecileValue = RESOURCE_AGE_IN_HOURS_DECILES[upperDecileIndex - 1];
110
+ const upperDecile = upperDecileIndex / 10;
111
+ const lowerDecile = (upperDecileIndex - 1) / 10;
112
+ // Approximate the real likelihood with linear interpolation
113
+ return linearInterpolation(lowerDecileValue, lowerDecile, upperDecileValue, upperDecile, maxAgeInHours);
114
+ }
115
+ export function getCombinedHeaders(responseHeaders) {
116
+ const headers = new Map();
117
+ for (const header of responseHeaders) {
118
+ const name = header.name.toLowerCase();
119
+ if (headers.get(name)) {
120
+ headers.set(name, `${headers.get(name)}, ${header.value}`);
121
+ }
122
+ else {
123
+ headers.set(name, header.value);
124
+ }
125
+ }
126
+ return headers;
127
+ }
128
+ /**
129
+ * Returns whether a request contains headers that disable caching.
130
+ * Disabled caching is checked on the 'cache-control' and 'pragma' headers.
131
+ */
132
+ export function cachingDisabled(headers, parsedCacheControl) {
133
+ const cacheControl = headers?.get('cache-control') ?? null;
134
+ const pragma = headers?.get('pragma') ?? null;
135
+ // The HTTP/1.0 Pragma header can disable caching if cache-control is not set, see https://tools.ietf.org/html/rfc7234#section-5.4
136
+ if (!cacheControl && pragma?.includes('no-cache')) {
137
+ return true;
138
+ }
139
+ // If we have any of these, the user intentionally doesn't want to cache.
140
+ if (parsedCacheControl &&
141
+ (parsedCacheControl['must-revalidate'] || parsedCacheControl['no-cache'] || parsedCacheControl['no-store'] ||
142
+ parsedCacheControl['private'])) {
143
+ return true;
144
+ }
145
+ return false;
146
+ }
147
+ export function isCacheInsight(model) {
148
+ return model.insightKey === InsightKeys.CACHE;
149
+ }
150
+ export function generateInsight(data, context) {
151
+ const isWithinContext = (event) => Helpers.Timing.eventIsInBounds(event, context.bounds);
152
+ const contextRequests = data.NetworkRequests.byTime.filter(isWithinContext);
153
+ const results = [];
154
+ let totalWastedBytes = 0;
155
+ const wastedBytesByRequestId = new Map();
156
+ for (const req of contextRequests) {
157
+ if (!req.args.data.responseHeaders || !isCacheable(req)) {
158
+ continue;
159
+ }
160
+ const headers = getCombinedHeaders(req.args.data.responseHeaders);
161
+ const cacheControl = headers.get('cache-control') ?? null;
162
+ const parsedDirectives = Helpers.Network.parseCacheControl(cacheControl);
163
+ // Skip requests that are deliberately avoiding caching.
164
+ if (cachingDisabled(headers, parsedDirectives)) {
165
+ continue;
166
+ }
167
+ let ttl = computeCacheLifetimeInSeconds(req.args.data.responseHeaders, parsedDirectives);
168
+ // Ignore if a non-positive number.
169
+ if (ttl !== null && (!Number.isFinite(ttl) || ttl <= 0)) {
170
+ continue;
171
+ }
172
+ ttl = ttl || 0;
173
+ // Ignore >= 30d.
174
+ const ttlDays = ttl / 86400;
175
+ if (ttlDays >= 30) {
176
+ continue;
177
+ }
178
+ // If cache lifetime is high enough, let's skip.
179
+ const cacheHitProbability = getCacheHitProbability(ttl);
180
+ if (cacheHitProbability > IGNORE_THRESHOLD_IN_PERCENT) {
181
+ continue;
182
+ }
183
+ const transferSize = req.args.data.encodedDataLength || 0;
184
+ const wastedBytes = (1 - cacheHitProbability) * transferSize;
185
+ wastedBytesByRequestId.set(req.args.data.requestId, wastedBytes);
186
+ totalWastedBytes += wastedBytes;
187
+ results.push({ request: req, ttl, wastedBytes });
188
+ }
189
+ // Sort by transfer size.
190
+ results.sort((a, b) => {
191
+ return b.request.args.data.decodedBodyLength - a.request.args.data.decodedBodyLength || a.ttl - b.ttl;
192
+ });
193
+ return finalize({
194
+ relatedEvents: results.map(r => r.request),
195
+ requests: results,
196
+ metricSavings: metricSavingsForWastedBytes(wastedBytesByRequestId, context),
197
+ wastedBytes: totalWastedBytes,
198
+ });
199
+ }
200
+ export function createOverlayForRequest(request) {
201
+ return {
202
+ type: 'ENTRY_OUTLINE',
203
+ entry: request,
204
+ outlineReason: 'ERROR',
205
+ };
206
+ }
207
+ export function createOverlays(model) {
208
+ return model.requests.map(req => createOverlayForRequest(req.request));
209
+ }
210
+ //# sourceMappingURL=Cache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Cache.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/Cache.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2025 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 Protocol from '../../../generated/protocol.js';\nimport type * as Handlers from '../handlers/handlers.js';\nimport * as Helpers from '../helpers/helpers.js';\nimport type * as Types from '../types/types.js';\n\nimport {metricSavingsForWastedBytes} from './Common.js';\nimport {linearInterpolation} from './Statistics.js';\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 information and suggestions of resources that could improve their caching.\n */\n title: 'Use efficient cache lifetimes',\n /**\n * @description Text to tell the user about how caching can help improve performance.\n */\n description:\n 'A long cache lifetime can speed up repeat visits to your page. [Learn more about caching](https://developer.chrome.com/docs/performance/insights/cache).',\n /**\n * @description Column for a font loaded by the page to render text.\n */\n requestColumn: 'Request',\n /**\n * @description Column for a resource cache's Time To Live.\n */\n cacheTTL: 'Cache TTL',\n /**\n * @description Text describing that there were no requests found that need caching.\n */\n noRequestsToCache: 'No requests with inefficient cache policies',\n /**\n * @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.\n * @example {5} PH1\n */\n others: '{PH1} others',\n} as const;\n\nconst str_ = i18n.i18n.registerUIStrings('models/trace/insights/Cache.ts', UIStrings);\nexport const i18nString: i18n.LocalizeString = i18n.i18n.getLocalizedString.bind(undefined, str_);\n\nexport type CacheInsightModel = InsightModel<typeof UIStrings, {\n requests: Array<{\n request: Types.Events.SyntheticNetworkRequest,\n ttl: number,\n wastedBytes: number,\n }>,\n}>;\n\n// Threshold for cache hits.\nconst IGNORE_THRESHOLD_IN_PERCENT = 0.925;\n\nfunction finalize(partialModel: PartialInsightModel<CacheInsightModel>): CacheInsightModel {\n return {\n insightKey: InsightKeys.CACHE,\n strings: UIStrings,\n title: i18nString(UIStrings.title),\n description: i18nString(UIStrings.description),\n docs: 'https://developer.chrome.com/docs/performance/insights/cache',\n category: InsightCategory.ALL,\n state: partialModel.requests.length > 0 ? 'fail' : 'pass',\n ...partialModel,\n };\n}\n\n/**\n * Determines if a request is \"cacheable\".\n * A request is \"cacheable\" if it is of the appropriate protocol and resource type\n * (see Helpers.Network.NON_NETWORK_SCHEMES and Helpers.Network.STATIC_RESOURCE_TYPE)\n * and has the appropriate statusCodes.\n */\nexport function isCacheable(request: Types.Events.SyntheticNetworkRequest): boolean {\n // Caching doesn't make sense for requests not loaded over the network.\n if (Helpers.Network.NON_NETWORK_SCHEMES.includes(request.args.data.protocol)) {\n return false;\n }\n return Boolean(\n Helpers.Network.CACHEABLE_STATUS_CODES.has(request.args.data.statusCode) &&\n Helpers.Network.STATIC_RESOURCE_TYPES.has(request.args.data.resourceType || Protocol.Network.ResourceType.Other));\n}\n\n/**\n * Returns max-age if defined, otherwise expires header if defined, and null if not.\n */\nexport function computeCacheLifetimeInSeconds(\n headers: Array<{name: string, value: string}>, cacheControl: Helpers.Network.CacheControl|null): number|null {\n if (cacheControl?.['max-age'] !== undefined) {\n return cacheControl['max-age'];\n }\n\n const expiresHeaders = headers.find(h => h.name === 'expires')?.value ?? null;\n if (expiresHeaders) {\n const expires = new Date(expiresHeaders).getTime();\n // Treat expires values as having already expired.\n if (!expires) {\n return 0;\n }\n return Math.ceil((expires - Date.now()) / 1000);\n }\n return null;\n}\n\n/**\n * Computes the percent likelihood that a return visit will be within the cache lifetime, based on\n * historical Chrome UMA stats (see RESOURCE_AGE_IN_HOURS_DECILES comment).\n *\n * This function returns values on this curve: https://www.desmos.com/calculator/eaqiszhugy (but using seconds, rather than hours)\n * See http://github.com/GoogleChrome/lighthouse/pull/3531 for history.\n */\nfunction getCacheHitProbability(maxAgeInSeconds: number): number {\n // This array contains the hand wavy distribution of the age of a resource in hours at the time of\n // cache hit at 0th, 10th, 20th, 30th, etc percentiles. This is used to compute `wastedMs` since there\n // are clearly diminishing returns to cache duration i.e. 6 months is not 2x better than 3 months.\n // Based on UMA stats for HttpCache.StaleEntry.Validated.Age. see https://www.desmos.com/calculator/jjwc5mzuwd\n // This UMA data is from 2017 but the metric isn't tracked any longer in 2025.\n const RESOURCE_AGE_IN_HOURS_DECILES = [0, 0.2, 1, 3, 8, 12, 24, 48, 72, 168, 8760, Infinity];\n\n const maxAgeInHours = maxAgeInSeconds / 3600;\n const upperDecileIndex = RESOURCE_AGE_IN_HOURS_DECILES.findIndex(decile => decile >= maxAgeInHours);\n\n // Clip the likelihood between 0 and 1\n if (upperDecileIndex === RESOURCE_AGE_IN_HOURS_DECILES.length - 1) {\n return 1;\n }\n if (upperDecileIndex === 0) {\n return 0;\n }\n\n // Use the two closest decile points as control points\n const upperDecileValue = RESOURCE_AGE_IN_HOURS_DECILES[upperDecileIndex];\n const lowerDecileValue = RESOURCE_AGE_IN_HOURS_DECILES[upperDecileIndex - 1];\n const upperDecile = upperDecileIndex / 10;\n const lowerDecile = (upperDecileIndex - 1) / 10;\n\n // Approximate the real likelihood with linear interpolation\n return linearInterpolation(lowerDecileValue, lowerDecile, upperDecileValue, upperDecile, maxAgeInHours);\n}\n\nexport function getCombinedHeaders(responseHeaders: Array<{name: string, value: string}>): Map<string, string> {\n const headers = new Map<string, string>();\n for (const header of responseHeaders) {\n const name = header.name.toLowerCase();\n if (headers.get(name)) {\n headers.set(name, `${headers.get(name)}, ${header.value}`);\n } else {\n headers.set(name, header.value);\n }\n }\n return headers;\n}\n\n/**\n * Returns whether a request contains headers that disable caching.\n * Disabled caching is checked on the 'cache-control' and 'pragma' headers.\n */\nexport function cachingDisabled(\n headers: Map<string, string>|null, parsedCacheControl: Helpers.Network.CacheControl|null): boolean {\n const cacheControl = headers?.get('cache-control') ?? null;\n const pragma = headers?.get('pragma') ?? null;\n\n // The HTTP/1.0 Pragma header can disable caching if cache-control is not set, see https://tools.ietf.org/html/rfc7234#section-5.4\n if (!cacheControl && pragma?.includes('no-cache')) {\n return true;\n }\n\n // If we have any of these, the user intentionally doesn't want to cache.\n if (parsedCacheControl &&\n (parsedCacheControl['must-revalidate'] || parsedCacheControl['no-cache'] || parsedCacheControl['no-store'] ||\n parsedCacheControl['private'])) {\n return true;\n }\n\n return false;\n}\n\nexport interface CacheableRequest {\n request: Types.Events.SyntheticNetworkRequest;\n ttl: number;\n wastedBytes: number;\n}\n\nexport function isCacheInsight(model: InsightModel): model is CacheInsightModel {\n return model.insightKey === InsightKeys.CACHE;\n}\n\nexport function generateInsight(data: Handlers.Types.HandlerData, context: InsightSetContext): CacheInsightModel {\n const isWithinContext = (event: Types.Events.Event): boolean => Helpers.Timing.eventIsInBounds(event, context.bounds);\n const contextRequests = data.NetworkRequests.byTime.filter(isWithinContext);\n\n const results: CacheableRequest[] = [];\n let totalWastedBytes = 0;\n const wastedBytesByRequestId = new Map<string, number>();\n for (const req of contextRequests) {\n if (!req.args.data.responseHeaders || !isCacheable(req)) {\n continue;\n }\n\n const headers = getCombinedHeaders(req.args.data.responseHeaders);\n const cacheControl = headers.get('cache-control') ?? null;\n const parsedDirectives = Helpers.Network.parseCacheControl(cacheControl);\n\n // Skip requests that are deliberately avoiding caching.\n if (cachingDisabled(headers, parsedDirectives)) {\n continue;\n }\n\n let ttl = computeCacheLifetimeInSeconds(req.args.data.responseHeaders, parsedDirectives);\n // Ignore if a non-positive number.\n if (ttl !== null && (!Number.isFinite(ttl) || ttl <= 0)) {\n continue;\n }\n ttl = ttl || 0;\n\n // Ignore >= 30d.\n const ttlDays = ttl / 86400;\n if (ttlDays >= 30) {\n continue;\n }\n\n // If cache lifetime is high enough, let's skip.\n const cacheHitProbability = getCacheHitProbability(ttl);\n if (cacheHitProbability > IGNORE_THRESHOLD_IN_PERCENT) {\n continue;\n }\n\n const transferSize = req.args.data.encodedDataLength || 0;\n const wastedBytes = (1 - cacheHitProbability) * transferSize;\n\n wastedBytesByRequestId.set(req.args.data.requestId, wastedBytes);\n totalWastedBytes += wastedBytes;\n\n results.push({request: req, ttl, wastedBytes});\n }\n\n // Sort by transfer size.\n results.sort((a, b) => {\n return b.request.args.data.decodedBodyLength - a.request.args.data.decodedBodyLength || a.ttl - b.ttl;\n });\n\n return finalize({\n relatedEvents: results.map(r => r.request),\n requests: results,\n metricSavings: metricSavingsForWastedBytes(wastedBytesByRequestId, context),\n wastedBytes: totalWastedBytes,\n });\n}\n\nexport function createOverlayForRequest(request: Types.Events.SyntheticNetworkRequest): Types.Overlays.EntryOutline {\n return {\n type: 'ENTRY_OUTLINE',\n entry: request,\n outlineReason: 'ERROR',\n };\n}\n\nexport function createOverlays(model: CacheInsightModel): Types.Overlays.Overlay[] {\n return model.requests.map(req => createOverlayForRequest(req.request));\n}\n"]}
@@ -6,35 +6,35 @@ export declare const UIStrings: {
6
6
  /**
7
7
  * @description Title of an insight that checks whether the page declares a character encoding early enough.
8
8
  */
9
- readonly title: "Declare a character encoding";
9
+ readonly title: 'Declare a character encoding';
10
10
  /**
11
11
  * @description Description of an insight that checks whether the page has a proper character encoding declaration via HTTP header or early meta tag.
12
12
  */
13
- readonly description: "A character encoding declaration is required. It can be done with a meta charset tag in the first 1024 bytes of the HTML or in the Content-Type HTTP response header. [Learn more about declaring the character encoding](https://developer.chrome.com/docs/insights/charset/).";
13
+ readonly description: 'A character encoding declaration is required. It can be done with a meta charset tag in the first 1024 bytes of the HTML or in the Content-Type HTTP response header. [Learn more about declaring the character encoding](https://developer.chrome.com/docs/insights/charset/).';
14
14
  /**
15
15
  * @description Text to tell the user that the charset is declared in the Content-Type HTTP response header.
16
16
  */
17
- readonly passingHttpHeader: "Declares charset in HTTP header";
17
+ readonly passingHttpHeader: 'Declares charset in HTTP header';
18
18
  /**
19
19
  * @description Text to tell the user that the charset is NOT declared in the Content-Type HTTP response header.
20
20
  */
21
- readonly failedHttpHeader: "Doesn’t declare charset in HTTP header";
21
+ readonly failedHttpHeader: 'Doesn’t declare charset in HTTP header';
22
22
  /**
23
23
  * @description Text to tell the user that a meta charset tag was found in the first 1024 bytes of the HTML.
24
24
  */
25
- readonly passingMetaCharsetEarly: "Declares charset using a meta tag in the first 1024 bytes";
25
+ readonly passingMetaCharsetEarly: 'Declares charset using a meta tag in the first 1024 bytes';
26
26
  /**
27
27
  * @description Text to tell the user that a meta charset tag was found, but too late in the HTML.
28
28
  */
29
- readonly failedMetaCharsetLate: "Declares charset using a meta tag after the first 1024 bytes";
29
+ readonly failedMetaCharsetLate: 'Declares charset using a meta tag after the first 1024 bytes';
30
30
  /**
31
31
  * @description Text to tell the user that no meta charset tag was found in the HTML.
32
32
  */
33
- readonly failedMetaCharsetMissing: "Doesn’t declare charset using a meta tag";
33
+ readonly failedMetaCharsetMissing: 'Doesn’t declare charset using a meta tag';
34
34
  /**
35
35
  * @description Text to tell the user that trace data did not include the Blink signal for meta charset.
36
36
  */
37
- readonly failedMetaCharsetUnknown: "Couldn’t determine meta charset declaration from trace";
37
+ readonly failedMetaCharsetUnknown: 'Couldn’t determine meta charset declaration from trace';
38
38
  };
39
39
  export declare const i18nString: i18n.LocalizeString;
40
40
  export type CharacterSetInsightModel = InsightModel<typeof UIStrings, {
@@ -0,0 +1,132 @@
1
+ // Copyright 2026 The Chromium Authors
2
+ // Use of this source code is governed by a BSD-style license that can be
3
+ // found in the LICENSE file.
4
+ import * as i18n from '../../../core/i18n/i18n.js';
5
+ import { InsightCategory, InsightKeys, InsightWarning, } from './types.js';
6
+ export const UIStrings = {
7
+ /**
8
+ * @description Title of an insight that checks whether the page declares a character encoding early enough.
9
+ */
10
+ title: 'Declare a character encoding',
11
+ /**
12
+ * @description Description of an insight that checks whether the page has a proper character encoding declaration via HTTP header or early meta tag.
13
+ */
14
+ description: 'A character encoding declaration is required. It can be done with a meta charset tag in the first 1024 bytes of the HTML or in the Content-Type HTTP response header. [Learn more about declaring the character encoding](https://developer.chrome.com/docs/insights/charset/).',
15
+ /**
16
+ * @description Text to tell the user that the charset is declared in the Content-Type HTTP response header.
17
+ */
18
+ passingHttpHeader: 'Declares charset in HTTP header',
19
+ /**
20
+ * @description Text to tell the user that the charset is NOT declared in the Content-Type HTTP response header.
21
+ */
22
+ failedHttpHeader: 'Doesn’t declare charset in HTTP header',
23
+ /**
24
+ * @description Text to tell the user that a meta charset tag was found in the first 1024 bytes of the HTML.
25
+ */
26
+ passingMetaCharsetEarly: 'Declares charset using a meta tag in the first 1024 bytes',
27
+ /**
28
+ * @description Text to tell the user that a meta charset tag was found, but too late in the HTML.
29
+ */
30
+ failedMetaCharsetLate: 'Declares charset using a meta tag after the first 1024 bytes',
31
+ /**
32
+ * @description Text to tell the user that no meta charset tag was found in the HTML.
33
+ */
34
+ failedMetaCharsetMissing: 'Doesn’t declare charset using a meta tag',
35
+ /**
36
+ * @description Text to tell the user that trace data did not include the Blink signal for meta charset.
37
+ */
38
+ failedMetaCharsetUnknown: 'Couldn’t determine meta charset declaration from trace',
39
+ };
40
+ const str_ = i18n.i18n.registerUIStrings('models/trace/insights/CharacterSet.ts', UIStrings);
41
+ export const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
42
+ const CHARSET_HTTP_REGEX = /charset\s*=\s*[a-zA-Z0-9\-_:.()]{2,}/i;
43
+ export function isCharacterSetInsight(model) {
44
+ return model.insightKey === InsightKeys.CHARACTER_SET;
45
+ }
46
+ function finalize(partialModel) {
47
+ let hasFailure = false;
48
+ if (partialModel.data) {
49
+ hasFailure = !partialModel.data.checklist.httpCharset.value && !partialModel.data.checklist.metaCharset.value;
50
+ }
51
+ return {
52
+ insightKey: InsightKeys.CHARACTER_SET,
53
+ strings: UIStrings,
54
+ title: i18nString(UIStrings.title),
55
+ description: i18nString(UIStrings.description),
56
+ docs: 'https://developer.chrome.com/docs/insights/charset/',
57
+ category: InsightCategory.ALL,
58
+ state: hasFailure ? 'fail' : 'pass',
59
+ ...partialModel,
60
+ };
61
+ }
62
+ function hasCharsetInContentType(request) {
63
+ if (!request.args.data.responseHeaders) {
64
+ return false;
65
+ }
66
+ for (const header of request.args.data.responseHeaders) {
67
+ if (header.name.toLowerCase() === 'content-type') {
68
+ return CHARSET_HTTP_REGEX.test(header.value);
69
+ }
70
+ }
71
+ return false;
72
+ }
73
+ function findMetaCharsetDisposition(data, context) {
74
+ if (!context.navigation) {
75
+ return undefined;
76
+ }
77
+ return data.PageLoadMetrics.metaCharsetCheckEventsByNavigation.get(context.navigation)
78
+ ?.at(-1)
79
+ ?.args.data?.disposition;
80
+ }
81
+ function metaCharsetLabel(disposition) {
82
+ switch (disposition) {
83
+ case 'found-in-first-1024-bytes':
84
+ return i18nString(UIStrings.passingMetaCharsetEarly);
85
+ case 'found-after-first-1024-bytes':
86
+ return i18nString(UIStrings.failedMetaCharsetLate);
87
+ case 'not-found':
88
+ return i18nString(UIStrings.failedMetaCharsetMissing);
89
+ default:
90
+ return i18nString(UIStrings.failedMetaCharsetUnknown);
91
+ }
92
+ }
93
+ export function generateInsight(data, context) {
94
+ if (!context.navigation || !('navigationId' in context)) {
95
+ return finalize({});
96
+ }
97
+ const documentRequest = data.NetworkRequests.byId.get(context.navigationId);
98
+ if (!documentRequest) {
99
+ return finalize({ warnings: [InsightWarning.NO_DOCUMENT_REQUEST] });
100
+ }
101
+ const hasHttpCharset = hasCharsetInContentType(documentRequest);
102
+ const metaCharsetDisposition = findMetaCharsetDisposition(data, context);
103
+ const hasMetaCharsetInFirst1024Bytes = metaCharsetDisposition === 'found-in-first-1024-bytes';
104
+ return finalize({
105
+ relatedEvents: [documentRequest],
106
+ data: {
107
+ hasHttpCharset,
108
+ metaCharsetDisposition,
109
+ documentRequest,
110
+ checklist: {
111
+ httpCharset: {
112
+ label: hasHttpCharset ? i18nString(UIStrings.passingHttpHeader) : i18nString(UIStrings.failedHttpHeader),
113
+ value: hasHttpCharset,
114
+ },
115
+ metaCharset: {
116
+ label: metaCharsetLabel(metaCharsetDisposition),
117
+ value: hasMetaCharsetInFirst1024Bytes,
118
+ },
119
+ },
120
+ },
121
+ });
122
+ }
123
+ export function createOverlays(model) {
124
+ if (!model.data?.documentRequest) {
125
+ return [];
126
+ }
127
+ return [{
128
+ type: 'ENTRY_SELECTED',
129
+ entry: model.data.documentRequest,
130
+ }];
131
+ }
132
+ //# sourceMappingURL=CharacterSet.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CharacterSet.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/CharacterSet.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,IAAI,MAAM,4BAA4B,CAAC;AAInD,OAAO,EAEL,eAAe,EACf,WAAW,EAGX,cAAc,GAEf,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;OAEG;IACH,KAAK,EAAE,8BAA8B;IACrC;;OAEG;IACH,WAAW,EACP,iRAAiR;IACrR;;OAEG;IACH,iBAAiB,EAAE,iCAAiC;IACpD;;OAEG;IACH,gBAAgB,EAAE,wCAAwC;IAC1D;;OAEG;IACH,uBAAuB,EAAE,2DAA2D;IACpF;;OAEG;IACH,qBAAqB,EAAE,8DAA8D;IACrF;;OAEG;IACH,wBAAwB,EAAE,0CAA0C;IACpE;;OAEG;IACH,wBAAwB,EAAE,wDAAwD;CAC1E,CAAC;AAEX,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,uCAAuC,EAAE,SAAS,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,UAAU,GAAwB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAElG,MAAM,kBAAkB,GAAG,uCAAuC,CAAC;AAWnE,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,OAAO,KAAK,CAAC,UAAU,KAAK,WAAW,CAAC,aAAa,CAAC;AACxD,CAAC;AAED,SAAS,QAAQ,CAAC,YAA2D;IAC3E,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,UAAU,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC;IAChH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,WAAW,CAAC,aAAa;QACrC,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC;QAClC,WAAW,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC;QAC9C,IAAI,EAAE,qDAAqD;QAC3D,QAAQ,EAAE,eAAe,CAAC,GAAG;QAC7B,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QACnC,GAAG,YAAY;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,OAA6C;IAC5E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,cAAc,EAAE,CAAC;YACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,0BAA0B,CAC/B,IAAgC,EAChC,OAA0B;IAE5B,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,eAAe,CAAC,kCAAkC,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;QAClF,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACR,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,WAA0D;IAClF,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,2BAA2B;YAC9B,OAAO,UAAU,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACvD,KAAK,8BAA8B;YACjC,OAAO,UAAU,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QACrD,KAAK,WAAW;YACd,OAAO,UAAU,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACxD;YACE,OAAO,UAAU,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC3B,IAAgC,EAAE,OAA0B;IAC9D,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,cAAc,IAAI,OAAO,CAAC,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC,EAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,mBAAmB,CAAC,EAAC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,cAAc,GAAG,uBAAuB,CAAC,eAAe,CAAC,CAAC;IAChE,MAAM,sBAAsB,GAAG,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzE,MAAM,8BAA8B,GAAG,sBAAsB,KAAK,2BAA2B,CAAC;IAE9F,OAAO,QAAQ,CAAC;QACd,aAAa,EAAE,CAAC,eAAe,CAAC;QAChC,IAAI,EAAE;YACJ,cAAc;YACd,sBAAsB;YACtB,eAAe;YACf,SAAS,EAAE;gBACT,WAAW,EAAE;oBACX,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,CAAC;oBACxG,KAAK,EAAE,cAAc;iBACtB;gBACD,WAAW,EAAE;oBACX,KAAK,EAAE,gBAAgB,CAAC,sBAAsB,CAAC;oBAC/C,KAAK,EAAE,8BAA8B;iBACtC;aACF;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA+B;IAC5D,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC;YACN,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe;SAClC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// Copyright 2026 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 type * as Handlers from '../handlers/handlers.js';\nimport type * as Types from '../types/types.js';\n\nimport {\n type Checklist,\n InsightCategory,\n InsightKeys,\n type InsightModel,\n type InsightSetContext,\n InsightWarning,\n type PartialInsightModel,\n} from './types.js';\n\nexport const UIStrings = {\n /**\n * @description Title of an insight that checks whether the page declares a character encoding early enough.\n */\n title: 'Declare a character encoding',\n /**\n * @description Description of an insight that checks whether the page has a proper character encoding declaration via HTTP header or early meta tag.\n */\n description:\n 'A character encoding declaration is required. It can be done with a meta charset tag in the first 1024 bytes of the HTML or in the Content-Type HTTP response header. [Learn more about declaring the character encoding](https://developer.chrome.com/docs/insights/charset/).',\n /**\n * @description Text to tell the user that the charset is declared in the Content-Type HTTP response header.\n */\n passingHttpHeader: 'Declares charset in HTTP header',\n /**\n * @description Text to tell the user that the charset is NOT declared in the Content-Type HTTP response header.\n */\n failedHttpHeader: 'Doesn’t declare charset in HTTP header',\n /**\n * @description Text to tell the user that a meta charset tag was found in the first 1024 bytes of the HTML.\n */\n passingMetaCharsetEarly: 'Declares charset using a meta tag in the first 1024 bytes',\n /**\n * @description Text to tell the user that a meta charset tag was found, but too late in the HTML.\n */\n failedMetaCharsetLate: 'Declares charset using a meta tag after the first 1024 bytes',\n /**\n * @description Text to tell the user that no meta charset tag was found in the HTML.\n */\n failedMetaCharsetMissing: 'Doesn’t declare charset using a meta tag',\n /**\n * @description Text to tell the user that trace data did not include the Blink signal for meta charset.\n */\n failedMetaCharsetUnknown: 'Couldn’t determine meta charset declaration from trace',\n} as const;\n\nconst str_ = i18n.i18n.registerUIStrings('models/trace/insights/CharacterSet.ts', UIStrings);\nexport const i18nString: i18n.LocalizeString = i18n.i18n.getLocalizedString.bind(undefined, str_);\n\nconst CHARSET_HTTP_REGEX = /charset\\s*=\\s*[a-zA-Z0-9\\-_:.()]{2,}/i;\n\nexport type CharacterSetInsightModel = InsightModel<typeof UIStrings, {\n data?: {\n hasHttpCharset: boolean,\n checklist: Checklist<'httpCharset'|'metaCharset'>,\n metaCharsetDisposition?: Types.Events.MetaCharsetDisposition,\n documentRequest?: Types.Events.SyntheticNetworkRequest,\n },\n}>;\n\nexport function isCharacterSetInsight(model: InsightModel): model is CharacterSetInsightModel {\n return model.insightKey === InsightKeys.CHARACTER_SET;\n}\n\nfunction finalize(partialModel: PartialInsightModel<CharacterSetInsightModel>): CharacterSetInsightModel {\n let hasFailure = false;\n if (partialModel.data) {\n hasFailure = !partialModel.data.checklist.httpCharset.value && !partialModel.data.checklist.metaCharset.value;\n }\n\n return {\n insightKey: InsightKeys.CHARACTER_SET,\n strings: UIStrings,\n title: i18nString(UIStrings.title),\n description: i18nString(UIStrings.description),\n docs: 'https://developer.chrome.com/docs/insights/charset/',\n category: InsightCategory.ALL,\n state: hasFailure ? 'fail' : 'pass',\n ...partialModel,\n };\n}\n\nfunction hasCharsetInContentType(request: Types.Events.SyntheticNetworkRequest): boolean {\n if (!request.args.data.responseHeaders) {\n return false;\n }\n for (const header of request.args.data.responseHeaders) {\n if (header.name.toLowerCase() === 'content-type') {\n return CHARSET_HTTP_REGEX.test(header.value);\n }\n }\n return false;\n}\n\nfunction findMetaCharsetDisposition(\n data: Handlers.Types.HandlerData,\n context: InsightSetContext,\n ): Types.Events.MetaCharsetDisposition|undefined {\n if (!context.navigation) {\n return undefined;\n }\n return data.PageLoadMetrics.metaCharsetCheckEventsByNavigation.get(context.navigation)\n ?.at(-1)\n ?.args.data?.disposition;\n}\n\nfunction metaCharsetLabel(disposition: Types.Events.MetaCharsetDisposition|undefined): ReturnType<typeof i18nString> {\n switch (disposition) {\n case 'found-in-first-1024-bytes':\n return i18nString(UIStrings.passingMetaCharsetEarly);\n case 'found-after-first-1024-bytes':\n return i18nString(UIStrings.failedMetaCharsetLate);\n case 'not-found':\n return i18nString(UIStrings.failedMetaCharsetMissing);\n default:\n return i18nString(UIStrings.failedMetaCharsetUnknown);\n }\n}\n\nexport function generateInsight(\n data: Handlers.Types.HandlerData, context: InsightSetContext): CharacterSetInsightModel {\n if (!context.navigation || !('navigationId' in context)) {\n return finalize({});\n }\n\n const documentRequest = data.NetworkRequests.byId.get(context.navigationId);\n if (!documentRequest) {\n return finalize({warnings: [InsightWarning.NO_DOCUMENT_REQUEST]});\n }\n\n const hasHttpCharset = hasCharsetInContentType(documentRequest);\n const metaCharsetDisposition = findMetaCharsetDisposition(data, context);\n const hasMetaCharsetInFirst1024Bytes = metaCharsetDisposition === 'found-in-first-1024-bytes';\n\n return finalize({\n relatedEvents: [documentRequest],\n data: {\n hasHttpCharset,\n metaCharsetDisposition,\n documentRequest,\n checklist: {\n httpCharset: {\n label: hasHttpCharset ? i18nString(UIStrings.passingHttpHeader) : i18nString(UIStrings.failedHttpHeader),\n value: hasHttpCharset,\n },\n metaCharset: {\n label: metaCharsetLabel(metaCharsetDisposition),\n value: hasMetaCharsetInFirst1024Bytes,\n },\n },\n },\n });\n}\n\nexport function createOverlays(model: CharacterSetInsightModel): Types.Overlays.Overlay[] {\n if (!model.data?.documentRequest) {\n return [];\n }\n\n return [{\n type: 'ENTRY_SELECTED',\n entry: model.data.documentRequest,\n }];\n}\n"]}