TracerBench Commands

This is the command reference for the TracerBench CLI.
Which has the following syntax:

      
tracerbench


CLI for TracerBench



tracerbench [COMMAND]


VERSION
  tracerbench/(semver) darwin-x64 node-v(semver)

USAGE
  $ tracerbench [COMMAND]

COMMANDS
  compare     Compare the performance delta between an experiment and control
  help        display help for tracerbench
  profile     Parses a CPU profile and aggregates time across heuristics.
  record-har  Generates a HAR file from a URL.

Optional Config

The optional existance of a tbconfig.json file in the project root will be consumed by TracerBench and specifies default command flag options. Please note this file is optional, however is strongly recommended as this drastically speeds up running TracerBench tests succinctly.

Cookies

The cookies.json format takes an array of cookies: https://chromedevtools.github.io/devtools-protocol/tot/Network#type-Cookie . The required keys are name, value, domain and path.

[
    {
      "name": "foo",
      "value": "COOKIE-VALUE-HERE",
      "domain": "www.foo.com",
      "path": "/"
    }
  ]

HAR File

HAR (HTTP Archive) is a JSON file format used by several HTTP session tools to export captured network data from a web session. The format is basically a JSON object with a particular field distribution. In any case, please note that not all the fields are mandatory, and many times some information won't be saved to the file. For more information review the HAR Analyzer Tool

Compare Command `compare.json` 

[{
  "meta": {
    "browserVersion": string,
    "cpus": string[]
  },
  "samples": IITerationSample[{
    "duration": number,
    "js": number,
    "phases": IPhaseSample[],
    "gc": IV8GCSample[],
    "blinkGC": IBlinkGCSample[],
    "runtimeCallStats": IRuntimeCallStats
  }],
  "set": string
}]