callsites
v4.2.0
Published
Get callsites from the V8 stack trace API
Downloads
200,477,423
Maintainers
Readme
callsites
Get callsites from the V8 stack trace API
Install
npm install callsites
Usage
import callsites from 'callsites';
function unicorn() {
console.log(callsites()[0].getFileName());
//=> '/Users/sindresorhus/dev/callsites/test.js'
}
unicorn();
API
Returns an array of callsite objects with the following methods:
getThis
: Returns the value ofthis
.getTypeName
: Returns the type ofthis
as a string. This is the name of the function stored in the constructor field ofthis
, if available, otherwise the object's[[Class]]
internal property.getFunction
: Returns the current function.getFunctionName
: Returns the name of the current function, typically itsname
property. If a name property is not available an attempt will be made to try to infer a name from the function's context.getMethodName
: Returns the name of the property ofthis
or one of its prototypes that holds the current function.getFileName
: If this function was defined in a script returns the name of the script.getLineNumber
: If this function was defined in a script returns the current line number.getColumnNumber
: If this function was defined in a script returns the current column numbergetEvalOrigin
: If this function was created using a call toeval
returns a string representing the location whereeval
was called.isToplevel
: Returnstrue
if this is a top-level invocation, that is, if it's a global object.isEval
: Returnstrue
if this call takes place in code defined by a call toeval
.isNative
: Returnstrue
if this call is in native V8 code.isConstructor
: Returnstrue
if this is a constructor call.isAsync()
: Returnstrue
if this call is asynchronous (i.e.await
,Promise.all()
, orPromise.any()
).isPromiseAll()
: Returnstrue
if this is an asynchronous call toPromise.all()
.getPromiseIndex()
: Returns the index of the promise element that was followed inPromise.all()
orPromise.any()
for async stack traces, ornull
if theCallSite
is not an asynchronousPromise.all()
orPromise.any()
call.