@tracerbench/trace-model

@tracerbench/trace-model

Builds a minimal model of the trace.

• Stable sorts events on ts.
• Assigns processes and threads metadata, bounds and events.
• Normalizes begin/end events into complete events and assigns parent refs from containment.
• Events are monomorphic and have access to the original trace event but all the basic props are lifted.
• Events have convenience methods for checking common phase types and accessing args.
• Category is split into a set if it is comma delimited and the disabled-by-default- prefix has been removed.

Example

import { buildModel } from '@tracerbench/trace-model';
import { readFileSync } from 'fs';
const trace = JSON.parse(readFileSync('trace.json', 'utf8'));
const model = buildModel(trace);
console.log(trace.start, trace.end, trace.duration);
for (const process of model.processes) {
  console.log(process.name);
  console.log(process.labels);
  console.log(process.start, process.end, process.duration);
  for (const thread of process.threads) {
    console.log(thread.name);
    console.log(thread.start, thread.end, thread.duration);
  }
}
const rendererMain = model.findRendererMain();
const slices = rendererMain.events.filter((event) => event.isComplete());
for (const toplevel of slices.filter((event) => event.parent === undefined)) {
  console.log('%o', toplevel);
}

Changelog

8.0.0 (2022-08-30)

• Upgrade dependencies and node engine to 16.x (#434) (d557588), closes #434
• chore(deps): bump cli-table3 from 0.6.0 to 0.6.2 (ebbbee0)
• chore(deps): bump debug from 4.3.3 to 4.3.4 (84dabed)
• chore(deps): bump ejs from 3.1.6 to 3.1.8 (47202d4)
• chore(deps): bump json5 from 2.2.0 to 2.2.1 (0194ef2)
• chore(deps): bump parse-url from 6.0.0 to 6.0.5 (50a3c55)
• feat: add documentation link in cli readme (0cbf116)
• feat: end recording trace at LCP if marker specifies (7e1ca9a)
• feat: export cli apis (7f645b7)
• feat: trace end at lcp (091aab5)
• feat: use markers config to decide if end at lcp (3602a59)