lighthouse 9.6.7 → 10.0.0

package/core/lib/dependency-graph/simulator/network-analyzer.js

@@ -0,0 +1,479 @@
+/**
+ * @license Copyright 2018 The Lighthouse Authors. All Rights Reserved.
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+ */
+
+import UrlUtils from '../../url-utils.js';
+
+const INITIAL_CWD = 14 * 1024;
+
+// Assume that 40% of TTFB was server response time by default for static assets
+const DEFAULT_SERVER_RESPONSE_PERCENTAGE = 0.4;
+
+/**
+ * For certain resource types, server response time takes up a greater percentage of TTFB (dynamic
+ * assets like HTML documents, XHR/API calls, etc)
+ * @type {Partial<Record<LH.Crdp.Network.ResourceType, number>>}
+ */
+const SERVER_RESPONSE_PERCENTAGE_OF_TTFB = {
+  Document: 0.9,
+  XHR: 0.9,
+  Fetch: 0.9,
+};
+
+class NetworkAnalyzer {
+  /**
+   * @return {string}
+   */
+  static get SUMMARY() {
+    return '__SUMMARY__';
+  }
+
+  /**
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @return {Map<string, LH.Artifacts.NetworkRequest[]>}
+   */
+  static groupByOrigin(records) {
+    const grouped = new Map();
+    records.forEach(item => {
+      const key = item.parsedURL.securityOrigin;
+      const group = grouped.get(key) || [];
+      group.push(item);
+      grouped.set(key, group);
+    });
+    return grouped;
+  }
+
+  /**
+   * @param {number[]} values
+   * @return {Summary}
+   */
+  static getSummary(values) {
+    values.sort((a, b) => a - b);
+
+    return {
+      min: values[0],
+      max: values[values.length - 1],
+      avg: values.reduce((a, b) => a + b, 0) / values.length,
+      median: values[Math.floor((values.length - 1) / 2)],
+    };
+  }
+
+  /**
+   * @param {Map<string,number[]>} values
+   * @return {Map<string, Summary>}
+   */
+  static summarize(values) {
+    const summaryByKey = new Map();
+    const allEstimates = [];
+    for (const [key, estimates] of values) {
+      summaryByKey.set(key, NetworkAnalyzer.getSummary(estimates));
+      allEstimates.push(...estimates);
+    }
+
+    summaryByKey.set(NetworkAnalyzer.SUMMARY, NetworkAnalyzer.getSummary(allEstimates));
+    return summaryByKey;
+  }
+
+  /** @typedef {{record: LH.Artifacts.NetworkRequest, timing: LH.Crdp.Network.ResourceTiming, connectionReused?: boolean}} RequestInfo */
+
+  /**
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @param {(e: RequestInfo) => number | number[] | undefined} iteratee
+   * @return {Map<string, number[]>}
+   */
+  static _estimateValueByOrigin(records, iteratee) {
+    const connectionWasReused = NetworkAnalyzer.estimateIfConnectionWasReused(records);
+    const groupedByOrigin = NetworkAnalyzer.groupByOrigin(records);
+
+    const estimates = new Map();
+    for (const [origin, originRecords] of groupedByOrigin.entries()) {
+      /** @type {number[]} */
+      let originEstimates = [];
+
+      for (const record of originRecords) {
+        const timing = record.timing;
+        if (!timing) continue;
+
+        const value = iteratee({
+          record,
+          timing,
+          connectionReused: connectionWasReused.get(record.requestId),
+        });
+        if (typeof value !== 'undefined') {
+          originEstimates = originEstimates.concat(value);
+        }
+      }
+
+      if (!originEstimates.length) continue;
+      estimates.set(origin, originEstimates);
+    }
+
+    return estimates;
+  }
+
+  /**
+   * Estimates the observed RTT to each origin based on how long the TCP handshake took.
+   * This is the most accurate and preferred method of measurement when the data is available.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @return {Map<string, number[]>}
+   */
+  static _estimateRTTByOriginViaTCPTiming(records) {
+    return NetworkAnalyzer._estimateValueByOrigin(records, ({timing, connectionReused}) => {
+      if (connectionReused) return;
+
+      // If the request was SSL we get two estimates, one for the SSL negotiation and another for the
+      // regular handshake. SSL can also be more than 1 RT but assume False Start was used.
+      if (timing.sslStart > 0 && timing.sslEnd > 0) {
+        return [timing.connectEnd - timing.sslStart, timing.sslStart - timing.connectStart];
+      } else if (timing.connectStart > 0 && timing.connectEnd > 0) {
+        return timing.connectEnd - timing.connectStart;
+      }
+    });
+  }
+
+  /**
+   * Estimates the observed RTT to each origin based on how long a download took on a fresh connection.
+   * NOTE: this will tend to overestimate the actual RTT quite significantly as the download can be
+   * slow for other reasons as well such as bandwidth constraints.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @return {Map<string, number[]>}
+   */
+  static _estimateRTTByOriginViaDownloadTiming(records) {
+    return NetworkAnalyzer._estimateValueByOrigin(records, ({record, timing, connectionReused}) => {
+      if (connectionReused) return;
+      // Only look at downloads that went past the initial congestion window
+      if (record.transferSize <= INITIAL_CWD) return;
+      if (!Number.isFinite(timing.receiveHeadersEnd) || timing.receiveHeadersEnd < 0) return;
+
+      // Compute the amount of time downloading everything after the first congestion window took
+      const totalTime = record.networkEndTime - record.networkRequestTime;
+      const downloadTimeAfterFirstByte = totalTime - timing.receiveHeadersEnd;
+      const numberOfRoundTrips = Math.log2(record.transferSize / INITIAL_CWD);
+
+      // Ignore requests that required a high number of round trips since bandwidth starts to play
+      // a larger role than latency
+      if (numberOfRoundTrips > 5) return;
+      return downloadTimeAfterFirstByte / numberOfRoundTrips;
+    });
+  }
+
+  /**
+   * Estimates the observed RTT to each origin based on how long it took until Chrome could
+   * start sending the actual request when a new connection was required.
+   * NOTE: this will tend to overestimate the actual RTT as the request can be delayed for other
+   * reasons as well such as more SSL handshakes if TLS False Start is not enabled.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @return {Map<string, number[]>}
+   */
+  static _estimateRTTByOriginViaSendStartTiming(records) {
+    return NetworkAnalyzer._estimateValueByOrigin(records, ({record, timing, connectionReused}) => {
+      if (connectionReused) return;
+      if (!Number.isFinite(timing.sendStart) || timing.sendStart < 0) return;
+
+      // Assume everything before sendStart was just DNS + (SSL)? + TCP handshake
+      // 1 RT for DNS, 1 RT (maybe) for SSL, 1 RT for TCP
+      let roundTrips = 2;
+      if (record.parsedURL.scheme === 'https') roundTrips += 1;
+      return timing.sendStart / roundTrips;
+    });
+  }
+
+  /**
+   * Estimates the observed RTT to each origin based on how long it took until Chrome received the
+   * headers of the response (~TTFB).
+   * NOTE: this is the most inaccurate way to estimate the RTT, but in some environments it's all
+   * we have access to :(
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @return {Map<string, number[]>}
+   */
+  static _estimateRTTByOriginViaHeadersEndTiming(records) {
+    return NetworkAnalyzer._estimateValueByOrigin(records, ({record, timing, connectionReused}) => {
+      if (!Number.isFinite(timing.receiveHeadersEnd) || timing.receiveHeadersEnd < 0) return;
+      if (!record.resourceType) return;
+
+      const serverResponseTimePercentage =
+        SERVER_RESPONSE_PERCENTAGE_OF_TTFB[record.resourceType] ||
+        DEFAULT_SERVER_RESPONSE_PERCENTAGE;
+      const estimatedServerResponseTime = timing.receiveHeadersEnd * serverResponseTimePercentage;
+
+      // When connection was reused...
+      // TTFB = 1 RT for request + server response time
+      let roundTrips = 1;
+
+      // When connection was fresh...
+      // TTFB = DNS + (SSL)? + TCP handshake + 1 RT for request + server response time
+      if (!connectionReused) {
+        roundTrips += 1; // DNS
+        if (record.parsedURL.scheme === 'https') roundTrips += 1; // SSL
+        roundTrips += 1; // TCP handshake
+      }
+
+      // subtract out our estimated server response time
+      return Math.max((timing.receiveHeadersEnd - estimatedServerResponseTime) / roundTrips, 3);
+    });
+  }
+
+  /**
+   * Given the RTT to each origin, estimates the observed server response times.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @param {Map<string, number>} rttByOrigin
+   * @return {Map<string, number[]>}
+   */
+  static _estimateResponseTimeByOrigin(records, rttByOrigin) {
+    return NetworkAnalyzer._estimateValueByOrigin(records, ({record, timing}) => {
+      if (!Number.isFinite(timing.receiveHeadersEnd) || timing.receiveHeadersEnd < 0) return;
+      if (!Number.isFinite(timing.sendEnd) || timing.sendEnd < 0) return;
+
+      const ttfb = timing.receiveHeadersEnd - timing.sendEnd;
+      const origin = record.parsedURL.securityOrigin;
+      const rtt = rttByOrigin.get(origin) || rttByOrigin.get(NetworkAnalyzer.SUMMARY) || 0;
+      return Math.max(ttfb - rtt, 0);
+    });
+  }
+
+  /**
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @return {boolean}
+   */
+  static canTrustConnectionInformation(records) {
+    const connectionIdWasStarted = new Map();
+    for (const record of records) {
+      const started = connectionIdWasStarted.get(record.connectionId) || !record.connectionReused;
+      connectionIdWasStarted.set(record.connectionId, started);
+    }
+
+    // We probably can't trust the network information if all the connection IDs were the same
+    if (connectionIdWasStarted.size <= 1) return false;
+    // Or if there were connections that were always reused (a connection had to have started at some point)
+    return Array.from(connectionIdWasStarted.values()).every(started => started);
+  }
+
+  /**
+   * Returns a map of requestId -> connectionReused, estimating the information if the information
+   * available in the records themselves appears untrustworthy.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @param {{forceCoarseEstimates: boolean}} [options]
+   * @return {Map<string, boolean>}
+   */
+  static estimateIfConnectionWasReused(records, options) {
+    const {forceCoarseEstimates = false} = options || {};
+
+    // Check if we can trust the connection information coming from the protocol
+    if (!forceCoarseEstimates && NetworkAnalyzer.canTrustConnectionInformation(records)) {
+      return new Map(records.map(record => [record.requestId, !!record.connectionReused]));
+    }
+
+    // Otherwise we're on our own, a record may not have needed a fresh connection if...
+    //   - It was not the first request to the domain
+    //   - It was H2
+    //   - It was after the first request to the domain ended
+    const connectionWasReused = new Map();
+    const groupedByOrigin = NetworkAnalyzer.groupByOrigin(records);
+    for (const [_, originRecords] of groupedByOrigin.entries()) {
+      const earliestReusePossible = originRecords
+        .map(record => record.networkEndTime)
+        .reduce((a, b) => Math.min(a, b), Infinity);
+
+      for (const record of originRecords) {
+        connectionWasReused.set(
+          record.requestId,
+          record.networkRequestTime >= earliestReusePossible || record.protocol === 'h2'
+        );
+      }
+
+      const firstRecord = originRecords.reduce((a, b) => {
+        return a.networkRequestTime > b.networkRequestTime ? b : a;
+      });
+      connectionWasReused.set(firstRecord.requestId, false);
+    }
+
+    return connectionWasReused;
+  }
+
+  /**
+   * Estimates the RTT to each origin by examining observed network timing information.
+   * Attempts to use the most accurate information first and falls back to coarser estimates when it
+   * is unavailable.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @param {RTTEstimateOptions} [options]
+   * @return {Map<string, Summary>}
+   */
+  static estimateRTTByOrigin(records, options) {
+    const {
+      forceCoarseEstimates = false,
+      // coarse estimates include lots of extra time and noise
+      // multiply by some factor to deflate the estimates a bit.
+      coarseEstimateMultiplier = 0.3,
+      useDownloadEstimates = true,
+      useSendStartEstimates = true,
+      useHeadersEndEstimates = true,
+    } = options || {};
+
+    let estimatesByOrigin = NetworkAnalyzer._estimateRTTByOriginViaTCPTiming(records);
+    if (!estimatesByOrigin.size || forceCoarseEstimates) {
+      estimatesByOrigin = new Map();
+      const estimatesViaDownload = NetworkAnalyzer._estimateRTTByOriginViaDownloadTiming(records);
+      const estimatesViaSendStart = NetworkAnalyzer._estimateRTTByOriginViaSendStartTiming(records);
+      const estimatesViaTTFB = NetworkAnalyzer._estimateRTTByOriginViaHeadersEndTiming(records);
+
+      for (const [origin, estimates] of estimatesViaDownload.entries()) {
+        if (!useDownloadEstimates) continue;
+        estimatesByOrigin.set(origin, estimates);
+      }
+
+      for (const [origin, estimates] of estimatesViaSendStart.entries()) {
+        if (!useSendStartEstimates) continue;
+        const existing = estimatesByOrigin.get(origin) || [];
+        estimatesByOrigin.set(origin, existing.concat(estimates));
+      }
+
+      for (const [origin, estimates] of estimatesViaTTFB.entries()) {
+        if (!useHeadersEndEstimates) continue;
+        const existing = estimatesByOrigin.get(origin) || [];
+        estimatesByOrigin.set(origin, existing.concat(estimates));
+      }
+
+      for (const estimates of estimatesByOrigin.values()) {
+        estimates.forEach((x, i) => (estimates[i] = x * coarseEstimateMultiplier));
+      }
+    }
+
+    if (!estimatesByOrigin.size) throw new Error('No timing information available');
+    return NetworkAnalyzer.summarize(estimatesByOrigin);
+  }
+
+  /**
+   * Estimates the server response time of each origin. RTT times can be passed in or will be
+   * estimated automatically if not provided.
+   *
+   * @param {LH.Artifacts.NetworkRequest[]} records
+   * @param {RTTEstimateOptions & {rttByOrigin?: Map<string, number>}} [options]
+   * @return {Map<string, Summary>}
+   */
+  static estimateServerResponseTimeByOrigin(records, options) {
+    let rttByOrigin = (options || {}).rttByOrigin;
+    if (!rttByOrigin) {
+      /** @type {Map<string, number>} */
+      rttByOrigin = new Map();
+
+      const rttSummaryByOrigin = NetworkAnalyzer.estimateRTTByOrigin(records, options);
+      for (const [origin, summary] of rttSummaryByOrigin.entries()) {
+        rttByOrigin.set(origin, summary.min);
+      }
+    }
+
+    const estimatesByOrigin = NetworkAnalyzer._estimateResponseTimeByOrigin(records, rttByOrigin);
+    return NetworkAnalyzer.summarize(estimatesByOrigin);
+  }
+
+
+  /**
+   * Computes the average throughput for the given records in bits/second.
+   * Excludes data URI, failed or otherwise incomplete, and cached requests.
+   * Returns Infinity if there were no analyzable network records.
+   *
+   * @param {Array<LH.Artifacts.NetworkRequest>} networkRecords
+   * @return {number}
+   */
+  static estimateThroughput(networkRecords) {
+    let totalBytes = 0;
+
+    // We will measure throughput by summing the total bytes downloaded by the total time spent
+    // downloading those bytes. We slice up all the network records into start/end boundaries, so
+    // it's easier to deal with the gaps in downloading.
+    const timeBoundaries = networkRecords.reduce((boundaries, record) => {
+      const scheme = record.parsedURL?.scheme;
+      // Requests whose bodies didn't come over the network or didn't completely finish will mess
+      // with the computation, just skip over them.
+      if (scheme === 'data' || record.failed || !record.finished ||
+          record.statusCode > 300 || !record.transferSize) {
+        return boundaries;
+      }
+
+      // If we've made it this far, all the times we need should be valid (i.e. not undefined/-1).
+      totalBytes += record.transferSize;
+      boundaries.push({time: record.responseHeadersEndTime / 1000, isStart: true});
+      boundaries.push({time: record.networkEndTime / 1000, isStart: false});
+      return boundaries;
+    }, /** @type {Array<{time: number, isStart: boolean}>} */([])).sort((a, b) => a.time - b.time);
+
+    if (!timeBoundaries.length) {
+      return Infinity;
+    }
+
+    let inflight = 0;
+    let currentStart = 0;
+    let totalDuration = 0;
+
+    timeBoundaries.forEach(boundary => {
+      if (boundary.isStart) {
+        if (inflight === 0) {
+          // We just ended a quiet period, keep track of when the download period started
+          currentStart = boundary.time;
+        }
+        inflight++;
+      } else {
+        inflight--;
+        if (inflight === 0) {
+          // We just entered a quiet period, update our duration with the time we spent downloading
+          totalDuration += boundary.time - currentStart;
+        }
+      }
+    });
+
+    return totalBytes * 8 / totalDuration;
+  }
+
+  /**
+   * @param {Array<LH.Artifacts.NetworkRequest>} records
+   * @param {string} resourceUrl
+   * @return {LH.Artifacts.NetworkRequest|undefined}
+   */
+  static findResourceForUrl(records, resourceUrl) {
+    // equalWithExcludedFragments is expensive, so check that the resourceUrl starts with the request url first
+    return records.find(request =>
+      resourceUrl.startsWith(request.url) &&
+      UrlUtils.equalWithExcludedFragments(request.url, resourceUrl)
+    );
+  }
+
+  /**
+   * Resolves redirect chain given a main document.
+   * See: {@link NetworkAnalyzer.findResourceForUrl}) for how to retrieve main document.
+   *
+   * @param {LH.Artifacts.NetworkRequest} request
+   * @return {LH.Artifacts.NetworkRequest}
+   */
+  static resolveRedirects(request) {
+    while (request.redirectDestination) request = request.redirectDestination;
+    return request;
+  }
+}
+
+export {NetworkAnalyzer};
+
+/**
+ * @typedef Summary
+ * @property {number} min
+ * @property {number} max
+ * @property {number} avg
+ * @property {number} median
+ */
+
+/**
+ * @typedef RTTEstimateOptions
+ * @property {boolean} [forceCoarseEstimates] TCP connection handshake information will be used when available, but in some circumstances this data can be unreliable. This flag exposes an option to ignore the handshake data and use the coarse download/TTFB timing data.
+ * @property {number} [coarseEstimateMultiplier] Coarse estimates include lots of extra time and noise multiply by some factor to deflate the estimates a bit.
+ * @property {boolean} [useDownloadEstimates] Useful for testing to isolate the different methods of estimation.
+ * @property {boolean} [useSendStartEstimates] Useful for testing to isolate the different methods of estimation.
+ * @property {boolean} [useHeadersEndEstimates] Useful for testing to isolate the different methods of estimation.
+ */

package/core/lib/dependency-graph/simulator/simulator-timing-map.d.ts

@@ -0,0 +1,153 @@
+export type Node = import('../base-node.js').Node;
+export type NetworkNode = import('../network-node.js').NetworkNode;
+export type CpuNode = import('../cpu-node.js').CPUNode;
+export type NodeTimingComplete = {
+    startTime: number;
+    endTime: number;
+    /**
+     * Helpful for debugging.
+     */
+    queuedTime: number;
+    estimatedTimeElapsed: number;
+    timeElapsed: number;
+    timeElapsedOvershoot: number;
+    bytesDownloaded: number;
+};
+export type NodeTimingQueued = Pick<NodeTimingComplete, 'queuedTime'>;
+export type CpuNodeTimingStarted = NodeTimingQueued & Pick<NodeTimingComplete, 'startTime' | 'timeElapsed'>;
+export type NetworkNodeTimingStarted = CpuNodeTimingStarted & Pick<NodeTimingComplete, 'timeElapsedOvershoot' | 'bytesDownloaded'>;
+export type CpuNodeTimingInProgress = CpuNodeTimingStarted & Pick<NodeTimingComplete, 'estimatedTimeElapsed'>;
+export type NetworkNodeTimingInProgress = NetworkNodeTimingStarted & Pick<NodeTimingComplete, 'estimatedTimeElapsed'>;
+export type CpuNodeTimingComplete = CpuNodeTimingInProgress & Pick<NodeTimingComplete, 'endTime'>;
+export type NetworkNodeTimingComplete = NetworkNodeTimingInProgress & Pick<NodeTimingComplete, 'endTime'> & {
+    connectionTiming: ConnectionTiming;
+};
+export type NodeTimingData = NodeTimingQueued | CpuNodeTimingStarted | NetworkNodeTimingStarted | CpuNodeTimingInProgress | NetworkNodeTimingInProgress | CpuNodeTimingComplete | NetworkNodeTimingComplete;
+/**
+ * A breakdown of network connection timings.
+ */
+export type ConnectionTiming = {
+    dnsResolutionTime?: number | undefined;
+    connectionTime?: number | undefined;
+    sslTime?: number | undefined;
+    timeToFirstByte: number;
+};
+/**
+ * @fileoverview
+ *
+ * This class encapsulates the type-related validation logic for moving timing information for nodes
+ * through the different simulation phases. Methods here ensure that the invariants of simulation hold
+ * as nodes are queued, partially simulated, and completed.
+ */
+/** @typedef {import('../base-node.js').Node} Node */
+/** @typedef {import('../network-node.js').NetworkNode} NetworkNode */
+/** @typedef {import('../cpu-node.js').CPUNode} CpuNode */
+/**
+ * @typedef NodeTimingComplete
+ * @property {number} startTime
+ * @property {number} endTime
+ * @property {number} queuedTime Helpful for debugging.
+ * @property {number} estimatedTimeElapsed
+ * @property {number} timeElapsed
+ * @property {number} timeElapsedOvershoot
+ * @property {number} bytesDownloaded
+ */
+/** @typedef {Pick<NodeTimingComplete, 'queuedTime'>} NodeTimingQueued */
+/** @typedef {NodeTimingQueued & Pick<NodeTimingComplete, 'startTime'|'timeElapsed'>} CpuNodeTimingStarted */
+/** @typedef {CpuNodeTimingStarted & Pick<NodeTimingComplete, 'timeElapsedOvershoot'|'bytesDownloaded'>} NetworkNodeTimingStarted */
+/** @typedef {CpuNodeTimingStarted & Pick<NodeTimingComplete, 'estimatedTimeElapsed'>} CpuNodeTimingInProgress */
+/** @typedef {NetworkNodeTimingStarted & Pick<NodeTimingComplete, 'estimatedTimeElapsed'>} NetworkNodeTimingInProgress */
+/** @typedef {CpuNodeTimingInProgress & Pick<NodeTimingComplete, 'endTime'>} CpuNodeTimingComplete */
+/** @typedef {NetworkNodeTimingInProgress & Pick<NodeTimingComplete, 'endTime'> & {connectionTiming: ConnectionTiming}} NetworkNodeTimingComplete */
+/** @typedef {NodeTimingQueued | CpuNodeTimingStarted | NetworkNodeTimingStarted | CpuNodeTimingInProgress | NetworkNodeTimingInProgress | CpuNodeTimingComplete | NetworkNodeTimingComplete} NodeTimingData */
+/**
+ * @typedef ConnectionTiming A breakdown of network connection timings.
+ * @property {number} [dnsResolutionTime]
+ * @property {number} [connectionTime]
+ * @property {number} [sslTime]
+ * @property {number} timeToFirstByte
+ */
+export class SimulatorTimingMap {
+    /** @type {Map<Node, NodeTimingData>} */
+    _nodeTimings: Map<Node, NodeTimingData>;
+    /** @return {Array<Node>} */
+    getNodes(): Array<Node>;
+    /**
+     * @param {Node} node
+     * @param {{queuedTime: number}} values
+     */
+    setReadyToStart(node: Node, values: {
+        queuedTime: number;
+    }): void;
+    /**
+     * @param {Node} node
+     * @param {{startTime: number}} values
+     */
+    setInProgress(node: Node, values: {
+        startTime: number;
+    }): void;
+    /**
+     * @param {Node} node
+     * @param {{endTime: number, connectionTiming?: ConnectionTiming}} values
+     */
+    setCompleted(node: Node, values: {
+        endTime: number;
+        connectionTiming?: ConnectionTiming;
+    }): void;
+    /**
+     * @param {CpuNode} node
+     * @param {{timeElapsed: number}} values
+     */
+    setCpu(node: CpuNode, values: {
+        timeElapsed: number;
+    }): void;
+    /**
+     * @param {CpuNode} node
+     * @param {{estimatedTimeElapsed: number}} values
+     */
+    setCpuEstimated(node: CpuNode, values: {
+        estimatedTimeElapsed: number;
+    }): void;
+    /**
+     * @param {NetworkNode} node
+     * @param {{timeElapsed: number, timeElapsedOvershoot: number, bytesDownloaded: number}} values
+     */
+    setNetwork(node: NetworkNode, values: {
+        timeElapsed: number;
+        timeElapsedOvershoot: number;
+        bytesDownloaded: number;
+    }): void;
+    /**
+     * @param {NetworkNode} node
+     * @param {{estimatedTimeElapsed: number}} values
+     */
+    setNetworkEstimated(node: NetworkNode, values: {
+        estimatedTimeElapsed: number;
+    }): void;
+    /**
+     * @param {Node} node
+     * @return {NodeTimingQueued}
+     */
+    getQueued(node: Node): NodeTimingQueued;
+    /**
+     * @param {CpuNode} node
+     * @return {CpuNodeTimingStarted}
+     */
+    getCpuStarted(node: CpuNode): CpuNodeTimingStarted;
+    /**
+     * @param {NetworkNode} node
+     * @return {NetworkNodeTimingStarted}
+     */
+    getNetworkStarted(node: NetworkNode): NetworkNodeTimingStarted;
+    /**
+     * @param {Node} node
+     * @return {CpuNodeTimingInProgress | NetworkNodeTimingInProgress}
+     */
+    getInProgress(node: Node): CpuNodeTimingInProgress | NetworkNodeTimingInProgress;
+    /**
+     * @param {Node} node
+     * @return {CpuNodeTimingComplete | NetworkNodeTimingComplete}
+     */
+    getCompleted(node: Node): CpuNodeTimingComplete | NetworkNodeTimingComplete;
+}
+//# sourceMappingURL=simulator-timing-map.d.ts.map