https://github.com/stringparser/callers-path
V8 stacktrace API based caller's path
https://github.com/stringparser/callers-path
Last synced: 6 months ago
JSON representation
V8 stacktrace API based caller's path
- Host: GitHub
- URL: https://github.com/stringparser/callers-path
- Owner: stringparser
- Created: 2014-10-03T10:45:33.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-06-23T10:59:22.000Z (over 10 years ago)
- Last Synced: 2025-06-25T20:05:04.440Z (7 months ago)
- Language: JavaScript
- Homepage:
- Size: 199 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# callers-path
[
](https://travis-ci.org/stringparser/callers-path/builds)
[
](http://www.npmjs.org/package/callers-path)
[V8 stacktrace API](https://code.google.com/p/v8/wiki/JavaScriptStackTraceApi) based caller's path
## install
npm install --save callers-path
## usage
example/moduleB.js
```js
var callersPath = require('callers-path');
module.exports = function(){
console.log(callersPath());
};
```
example/moduleA.js
```js
var moduleB = require('./moduleB');
moduleB();
// => example/moduleA.js
```
### documentation
`require('callers-path')([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 stack is sliced by one.
## 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`](https://github.com/visionmedia/callsite)
- [sindresorhus `callsites`](https://github.com/sindresorhus/callsites)
- [sindresorhus `caller-path`](https://github.com/sindresorhus/caller-path)
## test
npm test
### license
[
](http://opensource.org/licenses/MIT)