simpletrace

0.3.0 • Public • Published

SimpleTrace

Simple but powerful profiling mechanism to find bottlenecks in your code.

To begin

Install it

npm i simpletrace -D

Require it

// ES6 modules
import SimpleTrace from "simpletrace';

// CommonJS
const SimpleTrace = require("simpletrace");

Usage

const Profiler = new SimpleTrace("Simple prof", {
  writeFile: true,
  logs: false
});

debug across multiple files

If you want to debug across multiple files with the same profiler, just ask SimpleTrace for the instance:

const prof = new SimpleTrace("Simple prof");

If you debug across multiple files with the same profiler and you're not sure which file will run first, pass the options object to each constructor (new SimpleTrace)

You can even create multiple profilers that run in parallel!

options

Name Default Type Description
writeFile false Boolean write a file in the root directory of the project with the results
logs false Boolean log the results to the console
dir './simpleTrace' String change the directory of the output file, if the directory doesn't exist SimpleTrace will create it

API

.step

Insert new step to the log list

.end

End the profiling task and output to the console or/and file.

If writeFile is active SimpleTrace will save the file SimpleTrace-<name>-<Date.now()>.txt in the output directory.

Example

const SimpleTrace = require("simpletrace");

const profiler = new SimpleTrace("Debug awesomeFunction", {
writeFile: true,
logs: true
});

module.exports = (function awesomeFunction() {
  profiler.step("Starting awesomeFunction");

  profiler.step("Before getSomeAwesomeData");
  const data = getSomeAwesomeData();
  profiler.step("After getSomeAwesomeData");

  profiler.step("Before dataHashing");
  const hashing = dataHashing(data); // <-- This is our bottleneck
  profiler.step("After dataHashing");

  profiler.end();
})();

The output of the file:

Debug awesomeFunction results:
--------------------

Starting awesomeFunction - 0 ms
Before getSomeAwesomeData - 11 ms
After getSomeAwesomeData - 19.329 ms
Before dataHashing - 19.330 ms
After dataHashing - 5.501 sec

Dependents (0)

Package Sidebar

Install

npm i simpletrace

Weekly Downloads

2

Version

0.3.0

License

MIT

Unpacked Size

10.9 kB

Total Files

5

Last publish

Collaborators

  • spiral2k