lighthouse 9.5.0-dev.20220712 → 9.5.0-dev.20220713

package/lighthouse-core/computed/network-analysis.js

@@ -5,9 +5,9 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const NetworkAnalyzer = require('../lib/dependency-graph/simulator/network-analyzer.js');
-const NetworkRecords = require('./network-records.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import {NetworkAnalyzer} from '../lib/dependency-graph/simulator/network-analyzer.js';
+import NetworkRecords from './network-records.js';
 
 class NetworkAnalysis {
   /**
@@ -61,4 +61,4 @@ class NetworkAnalysis {
   }
 }
 
-module.exports = makeComputedArtifact(NetworkAnalysis, null);
+export default makeComputedArtifact(NetworkAnalysis, null);

package/lighthouse-core/computed/network-records.js

@@ -5,8 +5,8 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const NetworkRecorder = require('../lib/network-recorder.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import {NetworkRecorder} from '../lib/network-recorder.js';
 
 class NetworkRecords {
   /**
@@ -18,4 +18,4 @@ class NetworkRecords {
   }
 }
 
-module.exports = makeComputedArtifact(NetworkRecords, null);
+export default makeComputedArtifact(NetworkRecords, null);

package/lighthouse-core/computed/page-dependency-graph.js

@@ -5,14 +5,14 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const NetworkNode = require('../lib/dependency-graph/network-node.js');
-const CPUNode = require('../lib/dependency-graph/cpu-node.js');
-const TracingProcessor = require('../lib/tracehouse/trace-processor.js');
-const NetworkRequest = require('../lib/network-request.js');
-const ProcessedTrace = require('./processed-trace.js');
-const NetworkRecords = require('./network-records.js');
-const NetworkAnalyzer = require('../lib/dependency-graph/simulator/network-analyzer.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import {NetworkNode} from '../lib/dependency-graph/network-node.js';
+import {CPUNode} from '../lib/dependency-graph/cpu-node.js';
+import {TraceProcessor} from '../lib/tracehouse/trace-processor.js';
+import {NetworkRequest} from '../lib/network-request.js';
+import ProcessedTrace from './processed-trace.js';
+import NetworkRecords from './network-records.js';
+import {NetworkAnalyzer} from '../lib/dependency-graph/simulator/network-analyzer.js';
 
 /** @typedef {import('../lib/dependency-graph/base-node.js').Node} Node */
 /** @typedef {Omit<LH.Artifacts['URL'], 'initialUrl'|'finalUrl'>} URLArtifact */
@@ -111,14 +111,14 @@ class PageDependencyGraph {
     const nodes = [];
     let i = 0;
 
-    TracingProcessor.assertHasToplevelEvents(mainThreadEvents);
+    TraceProcessor.assertHasToplevelEvents(mainThreadEvents);
 
     while (i < mainThreadEvents.length) {
       const evt = mainThreadEvents[i];
       i++;
 
       // Skip all trace events that aren't schedulable tasks with sizable duration
-      if (!TracingProcessor.isScheduleableTask(evt) || !evt.dur) {
+      if (!TraceProcessor.isScheduleableTask(evt) || !evt.dur) {
         continue;
       }
 
@@ -504,7 +504,7 @@ class PageDependencyGraph {
   }
 }
 
-module.exports = makeComputedArtifact(PageDependencyGraph, ['devtoolsLog', 'trace', 'URL']);
+export default makeComputedArtifact(PageDependencyGraph, ['devtoolsLog', 'trace', 'URL']);
 
 /**
  * @typedef {Object} NetworkNodeOutput

package/lighthouse-core/computed/processed-navigation.js

@@ -5,8 +5,8 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const LHTraceProcessor = require('../lib/lh-trace-processor.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import LHTraceProcessor from '../lib/lh-trace-processor.js';
 
 class ProcessedNavigation {
   /**
@@ -18,4 +18,4 @@ class ProcessedNavigation {
   }
 }
 
-module.exports = makeComputedArtifact(ProcessedNavigation, null);
+export default makeComputedArtifact(ProcessedNavigation, null);

package/lighthouse-core/computed/processed-trace.js

@@ -5,8 +5,8 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const LHTraceProcessor = require('../lib/lh-trace-processor.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import LHTraceProcessor from '../lib/lh-trace-processor.js';
 
 class ProcessedTrace {
   /**
@@ -18,4 +18,4 @@ class ProcessedTrace {
   }
 }
 
-module.exports = makeComputedArtifact(ProcessedTrace, null);
+export default makeComputedArtifact(ProcessedTrace, null);

package/lighthouse-core/computed/resource-summary.js

@@ -5,12 +5,12 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const NetworkRecords = require('./network-records.js');
-const URL = require('../lib/url-shim.js');
-const NetworkRequest = require('../lib/network-request.js');
-const Budget = require('../config/budget.js');
-const {Util} = require('../util-commonjs.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import NetworkRecords from './network-records.js';
+import URL from '../lib/url-shim.js';
+import {NetworkRequest} from '../lib/network-request.js';
+import {Budget} from '../config/budget.js';
+import {Util} from '../util.cjs';
 
 /** @typedef {{count: number, resourceSize: number, transferSize: number}} ResourceEntry */
 
@@ -111,4 +111,4 @@ class ResourceSummary {
   }
 }
 
-module.exports = makeComputedArtifact(ResourceSummary, ['URL', 'devtoolsLog', 'budgets']);
+export default makeComputedArtifact(ResourceSummary, ['URL', 'devtoolsLog', 'budgets']);

package/lighthouse-core/computed/screenshots.js

@@ -5,7 +5,7 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
+import {makeComputedArtifact} from './computed-artifact.js';
 
 const SCREENSHOT_TRACE_NAME = 'Screenshot';
 
@@ -26,4 +26,4 @@ class Screenshots {
   }
 }
 
-module.exports = makeComputedArtifact(Screenshots, null);
+export default makeComputedArtifact(Screenshots, null);

package/lighthouse-core/computed/speedline.js

@@ -5,10 +5,10 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const speedline = require('speedline-core');
-const LighthouseError = require('../lib/lh-error.js');
-const ProcessedTrace = require('./processed-trace.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import speedline from 'speedline-core';
+import {LighthouseError} from '../lib/lh-error.js';
+import ProcessedTrace from './processed-trace.js';
 
 class Speedline {
   /**
@@ -51,4 +51,4 @@ class Speedline {
   }
 }
 
-module.exports = makeComputedArtifact(Speedline, null);
+export default makeComputedArtifact(Speedline, null);

package/lighthouse-core/computed/trace-of-tab.js

@@ -7,10 +7,11 @@
 
 /** @fileoverview This file is no longer used internally, but remains here for backcompat with plugins. */
 
-const log = require('lighthouse-logger');
-const makeComputedArtifact = require('./computed-artifact.js');
-const ProcessedTrace = require('./processed-trace.js');
-const ProcessedNavigation = require('./processed-navigation.js');
+import log from 'lighthouse-logger';
+
+import {makeComputedArtifact} from './computed-artifact.js';
+import ProcessedTrace from './processed-trace.js';
+import ProcessedNavigation from './processed-navigation.js';
 
 class TraceOfTab {
   /**
@@ -26,5 +27,5 @@ class TraceOfTab {
 }
 
 log.warn(`trace-of-tab`, `trace-of-tab is deprecated, use processed-trace / processed-navigation instead`); // eslint-disable-line max-len
-module.exports = makeComputedArtifact(TraceOfTab, null);
+export default makeComputedArtifact(TraceOfTab, null);
 

package/lighthouse-core/computed/unused-css.js

@@ -5,9 +5,9 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const ByteEfficiencyAudit = require('../audits/byte-efficiency/byte-efficiency-audit.js');
-const NetworkRecords = require('./network-records.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import {ByteEfficiencyAudit} from '../audits/byte-efficiency/byte-efficiency-audit.js';
+import NetworkRecords from './network-records.js';
 
 const PREVIEW_LENGTH = 100;
 
@@ -150,4 +150,4 @@ class UnusedCSS {
   }
 }
 
-module.exports = makeComputedArtifact(UnusedCSS, ['CSSUsage', 'devtoolsLog']);
+export default makeComputedArtifact(UnusedCSS, ['CSSUsage', 'devtoolsLog']);

package/lighthouse-core/computed/unused-javascript-summary.js

@@ -5,7 +5,7 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
+import {makeComputedArtifact} from './computed-artifact.js';
 
 /**
  * @typedef WasteData
@@ -149,7 +149,7 @@ class UnusedJavascriptSummary {
   }
 }
 
-module.exports = makeComputedArtifact(
+export default makeComputedArtifact(
   UnusedJavascriptSummary,
   ['bundle', 'scriptCoverage', 'scriptId']
 );

package/lighthouse-core/computed/user-timings.js

@@ -5,8 +5,8 @@
  */
 'use strict';
 
-const makeComputedArtifact = require('./computed-artifact.js');
-const ProcessedTrace = require('./processed-trace.js');
+import {makeComputedArtifact} from './computed-artifact.js';
+import ProcessedTrace from './processed-trace.js';
 
 /** @typedef {{name: string, isMark: true, args: LH.TraceEvent['args'], startTime: number}} MarkEvent */
 /** @typedef {{name: string, isMark: false, args: LH.TraceEvent['args'], startTime: number, endTime: number, duration: number}} MeasureEvent */
@@ -80,4 +80,4 @@ class UserTimings {
   }
 }
 
-module.exports = makeComputedArtifact(UserTimings, null);
+export default makeComputedArtifact(UserTimings, null);

package/lighthouse-core/computed/viewport-meta.js

@@ -5,9 +5,8 @@
  */
 'use strict';
 
-const Parser = require('metaviewport-parser');
-
-const makeComputedArtifact = require('./computed-artifact.js');
+import Parser from 'metaviewport-parser';
+import {makeComputedArtifact} from './computed-artifact.js';
 
 class ViewportMeta {
   /**
@@ -46,7 +45,7 @@ class ViewportMeta {
   }
 }
 
-module.exports = makeComputedArtifact(ViewportMeta, null);
+export default makeComputedArtifact(ViewportMeta, null);
 
 /**
  * @typedef {object} ViewportMetaResult

package/lighthouse-core/config/budget.js

@@ -338,4 +338,4 @@ class Budget {
   }
 }
 
-module.exports = Budget;
+export {Budget};

package/lighthouse-core/config/config-helpers.js

@@ -5,17 +5,21 @@
  */
 'use strict';
 
-const path = require('path');
-const isDeepEqual = require('lodash/isEqual.js');
-const constants = require('./constants.js');
-const Budget = require('./budget.js');
-const ConfigPlugin = require('./config-plugin.js');
-const Runner = require('../runner.js');
-const i18n = require('../lib/i18n/i18n.js');
-const validation = require('../fraggle-rock/config/validation.js');
-
-/** @typedef {typeof import('../gather/gatherers/gatherer.js')} GathererConstructor */
-/** @typedef {typeof import('../audits/audit.js')} Audit */
+import path from 'path';
+import {createRequire} from 'module';
+import isDeepEqual from 'lodash/isEqual.js';
+import * as constants from './constants.js';
+import {Budget} from './budget.js';
+import ConfigPlugin from './config-plugin.js';
+import {Runner} from '../runner.js';
+import * as i18n from '../lib/i18n/i18n.js';
+import * as validation from '../fraggle-rock/config/validation.js';
+import {getModuleDirectory} from '../../esm-utils.js';
+
+const require = createRequire(import.meta.url);
+
+/** @typedef {typeof import('../gather/gatherers/gatherer.js').Gatherer} GathererConstructor */
+/** @typedef {typeof import('../audits/audit.js')['Audit']} Audit */
 /** @typedef {InstanceType<GathererConstructor>} Gatherer */
 
 function isBundledEnvironment() {
@@ -203,17 +207,41 @@ function expandAuditShorthand(audit) {
   }
 }
 
-/** @type {Map<string, any>} */
+/** @type {Map<string, Promise<any>>} */
 const bundledModules = new Map(/* BUILD_REPLACE_BUNDLED_MODULES */);
 
 /**
- * Wraps `require` with an entrypoint for bundled dynamic modules.
+ * Wraps `import`/`require` with an entrypoint for bundled dynamic modules.
  * See build-bundle.js
  * @param {string} requirePath
  */
 async function requireWrapper(requirePath) {
-  // This is async because eventually this function needs to do async dynamic imports.
-  return bundledModules.get(requirePath) || require(requirePath);
+  /** @type {any} */
+  let module;
+  if (bundledModules.has(requirePath)) {
+    module = await bundledModules.get(requirePath);
+  } else if (requirePath.match(/\.(js|mjs|cjs)$/)) {
+    module = await import(requirePath);
+  } else {
+    requirePath += '.js';
+    module = await import(requirePath);
+  }
+
+  if (module.default) return module.default;
+
+  // Find a valid named export.
+  // TODO(esmodules): actually make all the audits/gatherers use named exports
+  const methods = new Set(['meta']);
+  const possibleNamedExports = Object.keys(module).filter(key => {
+    if (!(module[key] && module[key] instanceof Object)) return false;
+    return Object.getOwnPropertyNames(module[key]).some(method => methods.has(method));
+  });
+  if (possibleNamedExports.length === 1) return possibleNamedExports[0];
+  if (possibleNamedExports.length > 1) {
+    throw new Error(`module '${requirePath}' has too many possible exports`);
+  }
+
+  throw new Error(`module '${requirePath}' missing default export`);
 }
 
 /**
@@ -259,7 +287,7 @@ function requireAudit(auditPath, coreAuditList, configDir) {
       // Otherwise, attempt to find it elsewhere. This throws if not found.
       const absolutePath = resolveModulePath(auditPath, configDir, 'audit');
       // Use a relative path so bundler can easily expose it.
-      requirePath = path.relative(__dirname, absolutePath);
+      requirePath = path.relative(getModuleDirectory(import.meta), absolutePath);
     }
   }
 
@@ -478,8 +506,8 @@ function resolveModulePath(moduleIdentifier, configDir, category) {
 
   const errorString = 'Unable to locate ' + (category ? `${category}: ` : '') +
     `\`${moduleIdentifier}\`.
-     Tried to require() from these locations:
-       ${__dirname}
+     Tried to resolve the module from these locations:
+       ${getModuleDirectory(import.meta)}
        ${cwdPath}`;
 
   if (!configDir) {
@@ -592,7 +620,7 @@ function flagsToFRContext(flags) {
   };
 }
 
-module.exports = {
+export {
   deepClone,
   deepCloneConfigJson,
   mergeConfigFragment,

package/lighthouse-core/config/config-plugin.js

@@ -5,7 +5,7 @@
  */
 'use strict';
 
-const i18n = require('../lib/i18n/i18n.js');
+import * as i18n from '../lib/i18n/i18n.js';
 
 /**
  * @param {unknown} arr
@@ -248,4 +248,4 @@ class ConfigPlugin {
   }
 }
 
-module.exports = ConfigPlugin;
+export default ConfigPlugin;

package/lighthouse-core/config/config.js

@@ -5,16 +5,15 @@
  */
 'use strict';
 
-const defaultConfigPath = './default-config.js';
-const defaultConfig = require('./default-config.js');
-const constants = require('./constants.js');
-const format = require('../../shared/localization/format.js');
-const validation = require('./../fraggle-rock/config/validation.js');
-
-const log = require('lighthouse-logger');
-const path = require('path');
-const Runner = require('../runner.js');
-const {
+import defaultConfig from './default-config.js';
+import * as constants from './constants.js';
+import format from '../../shared/localization/format.js';
+import * as validation from './../fraggle-rock/config/validation.js';
+import log from 'lighthouse-logger';
+import path from 'path';
+import {Runner} from '../runner.js';
+
+import {
   mergePlugins,
   mergeConfigFragment,
   resolveSettings,
@@ -22,9 +21,12 @@ const {
   resolveGathererToDefn,
   deepClone,
   deepCloneConfigJson,
-} = require('./config-helpers.js');
+} from './config-helpers.js';
+import {getModuleDirectory} from '../../esm-utils.js';
+
+const defaultConfigPath = './default-config.js';
 
-/** @typedef {typeof import('../gather/gatherers/gatherer.js')} GathererConstructor */
+/** @typedef {typeof import('../gather/gatherers/gatherer.js').Gatherer} GathererConstructor */
 /** @typedef {InstanceType<GathererConstructor>} Gatherer */
 
 /**
@@ -167,7 +169,7 @@ class Config {
 
     if (!configJSON) {
       configJSON = defaultConfig;
-      configPath = path.resolve(__dirname, defaultConfigPath);
+      configPath = path.resolve(getModuleDirectory(import.meta), defaultConfigPath);
     }
 
     if (configPath && !path.isAbsolute(configPath)) {
@@ -559,4 +561,4 @@ class Config {
   }
 }
 
-module.exports = Config;
+export {Config};

package/lighthouse-core/config/constants.js

@@ -158,7 +158,7 @@ const nonSimulatedPassConfigOverrides = {
   cpuQuietThresholdMs: 5250,
 };
 
-module.exports = {
+export {
   throttling,
   screenEmulationMetrics,
   userAgents,

package/lighthouse-core/config/default-config.js

@@ -7,9 +7,10 @@
 
 /* eslint-disable max-len */
 
-const constants = require('./constants.js');
-const i18n = require('../lib/i18n/i18n.js');
-const m2a = require('./metrics-to-audits.js');
+import * as constants from './constants.js';
+
+import * as i18n from '../lib/i18n/i18n.js';
+import {metricsToAudits} from './metrics-to-audits.js';
 
 const UIStrings = {
   /** Title of the Performance category of audits. Equivalent to 'Web performance', this term is inclusive of all web page speed and loading optimization topics. Also used as a label of a score gauge; try to limit to 20 characters. */
@@ -120,7 +121,7 @@ const UIStrings = {
   pwaOptimizedGroupTitle: 'PWA Optimized',
 };
 
-const str_ = i18n.createMessageInstanceIdFn(__filename, UIStrings);
+const str_ = i18n.createMessageInstanceIdFn(import.meta.url, UIStrings);
 
 /** @type {LH.Config.Json} */
 const defaultConfig = {
@@ -413,12 +414,12 @@ const defaultConfig = {
       title: str_(UIStrings.performanceCategoryTitle),
       supportedModes: ['navigation', 'timespan', 'snapshot'],
       auditRefs: [
-        {id: 'first-contentful-paint', weight: 10, group: 'metrics', acronym: 'FCP', relevantAudits: m2a.fcpRelevantAudits},
+        {id: 'first-contentful-paint', weight: 10, group: 'metrics', acronym: 'FCP', relevantAudits: metricsToAudits.fcpRelevantAudits},
         {id: 'interactive', weight: 10, group: 'metrics', acronym: 'TTI'},
         {id: 'speed-index', weight: 10, group: 'metrics', acronym: 'SI'},
-        {id: 'total-blocking-time', weight: 30, group: 'metrics', acronym: 'TBT', relevantAudits: m2a.tbtRelevantAudits},
-        {id: 'largest-contentful-paint', weight: 25, group: 'metrics', acronym: 'LCP', relevantAudits: m2a.lcpRelevantAudits},
-        {id: 'cumulative-layout-shift', weight: 15, group: 'metrics', acronym: 'CLS', relevantAudits: m2a.clsRelevantAudits},
+        {id: 'total-blocking-time', weight: 30, group: 'metrics', acronym: 'TBT', relevantAudits: metricsToAudits.tbtRelevantAudits},
+        {id: 'largest-contentful-paint', weight: 25, group: 'metrics', acronym: 'LCP', relevantAudits: metricsToAudits.lcpRelevantAudits},
+        {id: 'cumulative-layout-shift', weight: 15, group: 'metrics', acronym: 'CLS', relevantAudits: metricsToAudits.clsRelevantAudits},
 
         // These are our "invisible" metrics. Not displayed, but still in the LHR.
         {id: 'max-potential-fid', weight: 0, group: 'hidden'},
@@ -624,10 +625,10 @@ const defaultConfig = {
   },
 };
 
-module.exports = defaultConfig;
+export default defaultConfig;
 
 // Use `defineProperty` so that the strings are accesible from original but ignored when we copy it
-Object.defineProperty(module.exports, 'UIStrings', {
+Object.defineProperty(defaultConfig, 'UIStrings', {
   enumerable: false,
   get: () => UIStrings,
 });

package/lighthouse-core/config/desktop-config.js

@@ -5,7 +5,7 @@
  */
 'use strict';
 
-const constants = require('./constants.js');
+import * as constants from './constants.js';
 
 /** @type {LH.Config.Json} */
 const config = {
@@ -18,4 +18,4 @@ const config = {
   },
 };
 
-module.exports = config;
+export default config;

package/lighthouse-core/config/experimental-config.js

@@ -27,4 +27,4 @@ const config = {
   },
 };
 
-module.exports = config;
+export default config;

package/lighthouse-core/config/full-config.js

@@ -11,4 +11,4 @@ const fullConfig = {
   settings: {},
 };
 
-module.exports = fullConfig;
+export default fullConfig;

package/lighthouse-core/config/lr-desktop-config.js

@@ -5,7 +5,7 @@
  */
 'use strict';
 
-const constants = require('./constants.js');
+import * as constants from './constants.js';
 
 /** @type {LH.Config.Json} */
 const config = {
@@ -22,4 +22,4 @@ const config = {
   },
 };
 
-module.exports = config;
+export default config;

package/lighthouse-core/config/lr-mobile-config.js

@@ -28,4 +28,4 @@ const config = {
   },
 };
 
-module.exports = config;
+export default config;

package/lighthouse-core/config/metrics-to-audits.js

@@ -52,7 +52,7 @@ const inpRelevantAudits = [
   'work-during-interaction',
 ];
 
-module.exports = {
+export const metricsToAudits = {
   fcpRelevantAudits,
   lcpRelevantAudits,
   tbtRelevantAudits,

package/lighthouse-core/config/perf-config.js

@@ -14,4 +14,4 @@ const perfConfig = {
   },
 };
 
-module.exports = perfConfig;
+export default perfConfig;

package/lighthouse-core/fraggle-rock/api.js

@@ -5,12 +5,12 @@
  */
 'use strict';
 
-const {UserFlow, auditGatherSteps} = require('./user-flow.js');
-const {snapshotGather} = require('./gather/snapshot-runner.js');
-const {startTimespanGather} = require('./gather/timespan-runner.js');
-const {navigationGather} = require('./gather/navigation-runner.js');
-const {generateFlowReportHtml} = require('../../report/generator/report-generator.js');
-const Runner = require('../runner.js');
+import {UserFlow, auditGatherSteps} from './user-flow.js';
+import {snapshotGather} from './gather/snapshot-runner.js';
+import {startTimespanGather} from './gather/timespan-runner.js';
+import {navigationGather} from './gather/navigation-runner.js';
+import ReportGenerator from '../../report/generator/report-generator.js';
+import {Runner} from '../runner.js';
 
 /**
  * @param {LH.Puppeteer.Page} page
@@ -55,7 +55,7 @@ async function startTimespan(...params) {
  * @param {LH.FlowResult} flowResult
  */
 async function generateFlowReport(flowResult) {
-  return generateFlowReportHtml(flowResult);
+  return ReportGenerator.generateFlowReportHtml(flowResult);
 }
 
 /**
@@ -67,7 +67,7 @@ async function auditFlowArtifacts(flowArtifacts, config) {
   return await auditGatherSteps(gatherSteps, {name, config});
 }
 
-module.exports = {
+export {
   snapshot,
   startTimespan,
   navigation,