v8-callsites

V8 stacktrace API callsites with knobs.

install

npm install --save v8-callsites

usage

1var stack = require('v8-callsites');
2
3origin();
4
5function origin(){
6  foo();
7}
8
9function foo(){
10  bar();
11}
12
13function bar(){
14  baz();
15}
16
17function baz(){
18
19  var barStackFrombaz = stack(3, bar);
20  // bar `stack` from baz with only 3 frames
21
22  barstackFrombaz.forEach(function(frame){
23    console.log(
24      frame.getFunctionName(), '->', frame+''
25    );
26  });
27}
28

documentation

require('v8-callsites')([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.

See also the avaliable methods of the stack trace api like:

• getLineNumber
• getFileName
• getEvalOrigin
• etc.

why

You would like to set how many frames are recorded (Error.stackTraceLimit) and from which function the stack should be traced back (Error.captureStackTrace).

By default two frames are recorded, though you can even lower it to one providing a function from which start.

inspirated by

It serves for the same use cases implemented on this cool modules

• visionmedia callsite
• sindresorhus callsites

I've been using those a lot.

test

npm test

license