mirror of
https://github.com/gosticks/DefinitelyTyped.git
synced 2025-10-16 12:05:41 +00:00
76 lines
2.5 KiB
TypeScript
76 lines
2.5 KiB
TypeScript
// Type definitions for stacktrace.js
|
|
// Project: https://github.com/stacktracejs/stacktrace.js
|
|
// Definitions by: Exceptionless <https://github.com/exceptionless>
|
|
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
|
|
|
declare namespace StackTrace {
|
|
export interface StackTraceOptions {
|
|
filter?: (stackFrame:StackFrame) => boolean;
|
|
sourceCache?: { URL:string };
|
|
offline?: boolean;
|
|
}
|
|
|
|
export interface StackFrame {
|
|
constructor(functionName:string, args:any, fileName:string, lineNumber:number, columnNumber:number): StackFrame;
|
|
|
|
functionName?:string;
|
|
args?:any;
|
|
fileName?:string;
|
|
lineNumber?:number;
|
|
columnNumber?:number;
|
|
toString():string;
|
|
}
|
|
|
|
/**
|
|
* Get a backtrace from invocation point.
|
|
* @param options Options Object
|
|
* @return Array[StackFrame]
|
|
*/
|
|
export function get(options?: StackTraceOptions): Promise<StackFrame[]>;
|
|
|
|
/**
|
|
* Given an error object, parse it.
|
|
* @param error Error object
|
|
* @param options Object for options
|
|
* @return Array[StackFrame]
|
|
*/
|
|
export function fromError(error:Error, options?:StackTraceOptions): Promise<StackFrame[]>;
|
|
|
|
/**
|
|
* Use StackGenerator to generate a backtrace.
|
|
* @param options Object options
|
|
* @returns Array[StackFrame]
|
|
*/
|
|
export function generateArtificially(options?: StackTraceOptions): Promise<StackFrame[]>;
|
|
|
|
/**
|
|
* Given a function, wrap it such that invocations trigger a callback that
|
|
* is called with a stack trace.
|
|
*
|
|
* @param {Function} fn to be instrumented
|
|
* @param {Function} callback function to call with a stack trace on invocation
|
|
* @param {Function} errback optional function to call with error if unable to get stack trace.
|
|
* @param {Object} thisArg optional context object (e.g. window)
|
|
* @return {Function} instrumented function
|
|
*/
|
|
export function instrument<TFunc extends Function>(fn: TFunc, callback: (stackFrames:StackFrame[]) => void, errback?: (error: Error) => void, thisArg?: any): TFunc;
|
|
|
|
/**
|
|
* Given a function that has been instrumented,
|
|
* revert the function to it's original (non-instrumented) state.
|
|
*
|
|
* @param fn {Function}
|
|
* @return {Function} original function
|
|
*/
|
|
export function deinstrument<TFunc extends Function>(fn: TFunc): TFunc;
|
|
|
|
/**
|
|
* Given an Array of StackFrames, serialize and POST to given URL.
|
|
*
|
|
* @param stackframes - Array[StackFrame]
|
|
* @param url - URL as String
|
|
* @return Promise<string>
|
|
*/
|
|
export function report(stackframes: StackFrame[], url: string): Promise<string>;
|
|
}
|