Callsite-tracker NPM

callsite-tracker

V8 stacktrace API-based information tool.

install

npm install callsite-tracker

example

var tracker = require('callsite-tracker');

describe('tracker', function (){

  it('should give me info!', function origin(){

    tracked = tracker(3, origin);
    should(tracked.module).be('mocha');
    console.log(tracked);
  })
})
// Of course! this is a mocha test file!
// its just to illustrate things better.

which will output

{
  module: 'mocha',
  scope: 'mocha/lib',
  path: '/home/jcm/npm/lib/node_modules/mocha/lib/runner.js',
  isCore: false,
  isNative: false,
  site:
   [ { receiver: [Object], fun: [Function: callFn], pos: 5274 },
     { receiver: [Object], fun: [Function], pos: 5169 },
     { receiver: [Object], fun: [Function], pos: 7711 } ] }

documentation

var tracker = require('callsite-tracker')([frames, origin])

frames if specified should be an integer bigger than 0 or Infinity.
origin if specified should be a function.
if no arguments, the default number of frames is 2 so the origin is the module itself. The returned stack is sliced by one.

The instance returned can walk through the recorded stack on a simple manner

var tracker = require('callsite-tracker');
var tracked = tracker(3);  // <- creates the `tracker` instance

tracked        // looks the same as the above output given
tracked.get(1) // will move to the second element of the sites array
               // and get the same information overriding
               // whatever value the properties had

tracker properties

Each tracker instance has attached the stack trace with the callsites. I called each "step" of the stack a frame. So if you had

callFn (/home/jcm/npm/lib/node_modules/mocha/lib/runnable.js:249:21)
Test.Runnable.run (/home/jcm/npm/lib/node_modules/mocha/lib/runnable.js:242:7)
Runner.runTest (/home/jcm/npm/lib/node_modules/mocha/lib/runner.js:373:10)

each line represents in my head a callsite frame. The first frame would be that of the caller.