* Registers and returns a branded synthetic event. Synthetic events need to * be created with this method to ensure they are registered and mad

* When the user passes in a set of handlers, we want to ensure that we have all * the required handlers. Handlers can depend on other handlers,

* @param {NetworkRequest} record The record to find the initiator of * @param {Map<string, NetworkRequest[]>} recordsByURL * @return {Ne

* Emits the appropriate network status event.

* @param {string} url * @param {{timeout: number}} options timeout is in ms * @return {Promise<FetchResponse>}

* @param {string} url * @return {Promise<FetchResponse>}

* @param {LH.Artifacts.Bundle} bundle * @param {number} generatedLine * @param {number} generatedColumn * @return {LH.Audit.Detai

* @param {string} sessionId * @return {LH.Gatherer.ProtocolSession}

* Returns a listener for all protocol events from session, and augments the * event with the sessionId. * @param {LH.Protocol.TargetType} target

* This handles both the auditMode case where gatherer entries need to be merged in and * the gather/audit case where timingEntriesFromRunner co

* Based on DevTools NetworkManager. * @see https://github.com/ChromeDevTools/devtools-frontend/blob/3415ee28e86a3f4bcc2e15b652d22069938df3a6/fr

* @param {string} targetType * @return {targetType is LH.Protocol.TargetType}

* Returns true if the event is a navigation start event of a document whose URL seems valid. * * @param {LH.TraceEvent} event * @

* @param {string} url * @return {Promise<{stream: LH.Crdp.IO.StreamHandle|null, status: number|null}>}

* @param {string} content * @param {number} maxLineLength * @return {LH.Audit.Details.SnippetValue['lines']}

* @param {number|null} score * @param {LH.Audit.ScoreDisplayMode} scoreDisplayMode * @param {string} auditId * @return {number|nu

* @param {LH.Puppeteer.CDPSession} cdpSession

* Extract and validate the list of category AuditRefs added by the plugin. * @param {unknown} auditRefsJson * @param {string} pluginName

* Extract and validate the list of AuditDefns added by the plugin (or undefined * if no additional audits are being added by the plugin).

* Extract and validate the category added by the plugin. * @param {unknown} categoryJson * @param {string} pluginName * @return {

* Extract and validate groups JSON added by the plugin. * @param {unknown} groupsJson * @param {string} pluginName * @return {Rec

* @param {LH.Audit.ProductMetricSavings|undefined} metricSavings * @return {LH.Audit.ProductMetricSavings|undefined}

* @param {string} handle * @param {{timeout: number}=} options, * @return {Promise<string>}

* Resolve differences between conflicting timing signals. Based on the property setters in DevTools. * @see https://github.com/ChromeDevTools/d

* @param {string} url * @param {string} base * @return {string|undefined}

* @param {LH.Gatherer.Driver} driver * @param {LH.Artifacts.Script} script * @return {Promise<LH.Artifacts.SourceMap>}

* Calculate duration at specified percentiles for given population of * durations. * If one of the durations overlaps the end of the win

* Checks that the audit's required artifacts exist and runs the audit if so. * Otherwise returns error audit result. * @param {LH.Config

* Run all audits with specified settings and artifacts. * @param {LH.Config.Settings} settings * @param {Array<LH.Config.AuditDefn>} aud

* This method sorts a group of trace events that have the same timestamp. We want to... * * 1. Put E events first, we finish off our exi

* LR loses protocol information.