97 lines
2.3 KiB
TypeScript
97 lines
2.3 KiB
TypeScript
|
declare namespace callsites {
|
||
|
interface CallSite {
|
||
|
/**
|
||
|
Returns the value of `this`.
|
||
|
*/
|
||
|
getThis(): unknown | undefined;
|
||
|
|
||
|
/**
|
||
|
Returns the type of `this` as a string. This is the name of the function stored in the constructor field of `this`, if available, otherwise the object's `[[Class]]` internal property.
|
||
|
*/
|
||
|
getTypeName(): string | null;
|
||
|
|
||
|
/**
|
||
|
Returns the current function.
|
||
|
*/
|
||
|
getFunction(): Function | undefined;
|
||
|
|
||
|
/**
|
||
|
Returns the name of the current function, typically its `name` property. If a name property is not available an attempt will be made to try to infer a name from the function's context.
|
||
|
*/
|
||
|
getFunctionName(): string | null;
|
||
|
|
||
|
/**
|
||
|
Returns the name of the property of `this` or one of its prototypes that holds the current function.
|
||
|
*/
|
||
|
getMethodName(): string | undefined;
|
||
|
|
||
|
/**
|
||
|
Returns the name of the script if this function was defined in a script.
|
||
|
*/
|
||
|
getFileName(): string | null;
|
||
|
|
||
|
/**
|
||
|
Returns the current line number if this function was defined in a script.
|
||
|
*/
|
||
|
getLineNumber(): number | null;
|
||
|
|
||
|
/**
|
||
|
Returns the current column number if this function was defined in a script.
|
||
|
*/
|
||
|
getColumnNumber(): number | null;
|
||
|
|
||
|
/**
|
||
|
Returns a string representing the location where `eval` was called if this function was created using a call to `eval`.
|
||
|
*/
|
||
|
getEvalOrigin(): string | undefined;
|
||
|
|
||
|
/**
|
||
|
Returns `true` if this is a top-level invocation, that is, if it's a global object.
|
||
|
*/
|
||
|
isToplevel(): boolean;
|
||
|
|
||
|
/**
|
||
|
Returns `true` if this call takes place in code defined by a call to `eval`.
|
||
|
*/
|
||
|
isEval(): boolean;
|
||
|
|
||
|
/**
|
||
|
Returns `true` if this call is in native V8 code.
|
||
|
*/
|
||
|
isNative(): boolean;
|
||
|
|
||
|
/**
|
||
|
Returns `true` if this is a constructor call.
|
||
|
*/
|
||
|
isConstructor(): boolean;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
declare const callsites: {
|
||
|
/**
|
||
|
Get callsites from the V8 stack trace API.
|
||
|
|
||
|
@returns An array of `CallSite` objects.
|
||
|
|
||
|
@example
|
||
|
```
|
||
|
import callsites = require('callsites');
|
||
|
|
||
|
function unicorn() {
|
||
|
console.log(callsites()[0].getFileName());
|
||
|
//=> '/Users/sindresorhus/dev/callsites/test.js'
|
||
|
}
|
||
|
|
||
|
unicorn();
|
||
|
```
|
||
|
*/
|
||
|
(): callsites.CallSite[];
|
||
|
|
||
|
// TODO: Remove this for the next major release, refactor the whole definition to:
|
||
|
// declare function callsites(): callsites.CallSite[];
|
||
|
// export = callsites;
|
||
|
default: typeof callsites;
|
||
|
};
|
||
|
|
||
|
export = callsites;
|