Home

Awesome

Clinic.js Flame

npm version Stability Stable Github Actions build status Downloads Code style

Programmable interface to Clinic.js Flame. Learn more about Clinic.js: https://clinicjs.org/

Screenshot

Issues

To open an issue, please use the main repository with the flame label.

Installation

npm i -S @clinic/flame

Supported node versions

Example

const ClinicFlame = require('@clinic/flame')
const flame = new ClinicFlame()

flame.collect(['node', './path-to-script.js'], function (err, filepath) {
  if (err) throw err

  flame.visualize(filepath, filepath + '.html', function (err) {
    if (err) throw err
  })
})

Documentation

const ClinicFlame = require('@clinic/flame')
const flame = new ClinicFlame()

new ClinicFlame([settings])

flame.collect(args, callback)

Starts a process by using 0x

0x will produce a file in the current working directory, with the process PID in its filename. The filepath relative to the current working directory will be the value in the callback.

stdout, stderr, and stdin will be relayed to the calling process. As will the SIGINT event.

flame.visualize(dataFilename, outputFilename, callback)

Will consume the datafile specified by dataFilename, this datafile will be produced by the sampler using flame.collect.

flame.visualize will then output a standalone HTML file to outputFilename. When completed the callback will be called with no extra arguments, except a possible error.

License

MIT