Method parse

front_end/models/trace/ModelImpl.ts:80–119

* Parses an array of trace events into a structured object containing all the * information parsed by the trace handlers. * You can `await` this function to pause execution until parsing is complete, * or instead rely on the `ModuleUpdateEvent` that is dispatched when the * parsing is fi

(traceEvents: readonly Types.Events.Event[], config: Types.Configuration.ParseOptions = {})

   * void this.traceModel.parse(events);
   **/
  async parse(traceEvents: readonly Types.Events.Event[], config: Types.Configuration.ParseOptions = {}):
      Promise<void> {
    if (config.showAllEvents === undefined) {
      config.showAllEvents = this.#config.showAllEvents;
    }

    const metadata = config.metadata || {};
    // During parsing, periodically update any listeners on each processors'
    // progress (if they have any updates).
    const onTraceUpdate = (event: Event): void => {
      const {data} = event as TraceParseProgressEvent;
      this.dispatchEvent(new ModelUpdateEvent({type: ModelUpdateType.PROGRESS_UPDATE, data}));
    };

    this.#processor.addEventListener(TraceParseProgressEvent.eventName, onTraceUpdate);

    // TODO(cjamcl): this.#processor.parse needs this to work. So it should either take it as input, or create it itself.
    const syntheticEventsManager = Helpers.SyntheticEvents.SyntheticEventsManager.createAndActivate(traceEvents);

    try {
      // Wait for all outstanding promises before finishing the async execution,
      // but perform all tasks in parallel.
      await this.#processor.parse(traceEvents, config);
      if (!this.#processor.data) {
        throw new Error('processor did not parse trace');
      }
      const file = this.#storeAndCreateParsedTraceFile(
          syntheticEventsManager, traceEvents, metadata, this.#processor.data, this.#processor.insights);
      // We only push the file onto this.#traces here once we know it's valid
      // and there's been no errors in the parsing.
      this.#traces.push(file);
    } catch (e) {
      throw e;
    } finally {
      // All processors have finished parsing, no more updates are expected.
      this.#processor.removeEventListener(TraceParseProgressEvent.eventName, onTraceUpdate);
      // Finally, update any listeners that all processors are 'done'.
      this.dispatchEvent(new ModelUpdateEvent({type: ModelUpdateType.COMPLETE, data: 'done'}));
    }
  }

  #storeAndCreateParsedTraceFile(
      syntheticEventsManager: Helpers.SyntheticEvents.SyntheticEventsManager,